davinci-resolve-mcp

Switch to a specific page in DaVinci Resolve. Args: page: The page to switch to. Options: 'media', 'cut', 'edit', 'fusion', 'color', 'fairlight', 'deliver'

Set a project setting to the specified value. Args: setting_name: The name of the setting to change setting_value: The new value for the setting (can be string, integer, float, or boolean)

Open a project by name. Args: name: The name of the project to open

Create a new project with the given name. Args: name: The name for the new project

Save the current project. Note that DaVinci Resolve typically auto-saves projects, so this may not be necessary.

Close the current project. This closes the current project without saving. If you need to save, use the save_project function first.

Create a new timeline with the given name. Args: name: The name for the new timeline

Create a new timeline with the given name and custom settings. Args: name: The name for the new timeline frame_rate: Optional frame rate (e.g. "24", "29.97", "30", "60") resolution_width: Optional width in pixels (e.g. 1920) resolution_height: Optional height in pixels (e.g. 1080) start_timecode: Op…

Delete a timeline by name. Args: name: The name of the timeline to delete

Switch to a timeline by name. Args: name: The name of the timeline to set as current

Add a marker at the specified frame in the current timeline. Args: frame: The frame number to add the marker at (defaults to current position if None) color: The marker color (Blue, Cyan, Green, Yellow, Red, Pink, Purple, Fuchsia, Rose, Lavender, Sky, Mint, Lemon, Sand, Cocoa, Cream) note: Text note…

Import media file into the current project's media pool. Args: file_path: The path to the media file to import

Delete a media clip from the media pool by name. Args: clip_name: Name of the clip to delete

Move a media clip to a specific bin in the media pool. Args: clip_name: Name of the clip to move bin_name: Name of the target bin

Sync audio between clips with customizable settings. Args: clip_names: List of clip names to sync sync_method: Method to use for synchronization - 'waveform' or 'timecode' append_mode: Whether to append the audio or replace it target_bin: Optional bin to move synchronized clips to

Unlink specified clips, disconnecting them from their media files. Args: clip_names: List of clip names to unlink

Relink specified clips to their media files. Args: clip_names: List of clip names to relink media_paths: Optional list of specific media file paths to use for relinking folder_path: Optional folder path to search for media files recursive: Whether to search the folder path recursively

Create a subclip from the specified clip using in and out points. Args: clip_name: Name of the source clip start_frame: Start frame (in point) end_frame: End frame (out point) sub_clip_name: Optional name for the subclip (defaults to original name with '_subclip') bin_name: Optional bin to place the…

Create a new bin/folder in the media pool. Args: name: The name for the new bin

List all timelines in the current project as a tool.

Add a media pool clip to the timeline. Args: clip_name: Name of the clip in the media pool timeline_name: Optional timeline to target (uses current if not specified)

Apply a LUT to a node in the color page. Args: lut_path: Path to the LUT file to apply node_index: Index of the node to apply the LUT to (uses current node if None)

Set a color wheel parameter for a node. Args: wheel: Which color wheel to adjust ('lift', 'gamma', 'gain', 'offset') param: Which parameter to adjust ('red', 'green', 'blue', 'master') value: The value to set (typically between -1.0 and 1.0) node_index: Index of the node to set parameter for (uses c…

Add a new node to the current grade in the color page. Args: node_type: Type of node to add. Options: 'serial', 'parallel', 'layer' label: Optional label/name for the new node

Copy a grade from one clip to another in the color page. Args: source_clip_name: Name of the source clip to copy grade from (uses current clip if None) target_clip_name: Name of the target clip to apply grade to (uses current clip if None) mode: What to copy - 'full' (entire grade), 'current_node', …

Add a timeline to the render queue with the specified preset. Args: preset_name: Name of the render preset to use timeline_name: Name of the timeline to render (uses current if None) use_in_out_range: Whether to render only the in/out range instead of entire timeline

Start rendering the jobs in the render queue.

Clear all jobs from the render queue.

Link a proxy media file to a clip. Args: clip_name: Name of the clip to link proxy to proxy_file_path: Path to the proxy media file

Unlink proxy media from a clip. Args: clip_name: Name of the clip to unlink proxy from

Replace a clip with another media file. Args: clip_name: Name of the clip to be replaced replacement_path: Path to the replacement media file

Transcribe audio for a clip. Args: clip_name: Name of the clip to transcribe language: Language code for transcription (default: en-US)

Clear audio transcription for a clip. Args: clip_name: Name of the clip to clear transcription from

Export a folder to a DRB file or other format. Args: folder_name: Name of the folder to export export_path: Path to save the exported file export_type: Export format (DRB is default and currently the only supported option)

Transcribe audio for all clips in a folder. Args: folder_name: Name of the folder containing clips to transcribe language: Language code for transcription (default: en-US)

Clear audio transcription for all clips in a folder. Args: folder_name: Name of the folder to clear transcriptions from

Set cache mode for the current project. Args: mode: Cache mode to set. Options: 'auto', 'on', 'off'

Set optimized media mode for the current project. Args: mode: Optimized media mode to set. Options: 'auto', 'on', 'off'

Set proxy media mode for the current project. Args: mode: Proxy mode to set. Options: 'auto', 'on', 'off'

Set proxy media quality for the current project. Args: quality: Proxy quality to set. Options: 'quarter', 'half', 'threeQuarter', 'full'

Set cache file path for the current project. Args: path_type: Type of cache path to set. Options: 'local', 'network' path: File system path for the cache

Generate optimized media for specified clips or all clips if none specified. Args: clip_names: Optional list of clip names. If None, processes all clips in media pool

Delete optimized media for specified clips or all clips if none specified. Args: clip_names: Optional list of clip names. If None, processes all clips in media pool

Set a transform property for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify property_name: The name of the property to set. Options include: 'Pan', 'Tilt', 'ZoomX', 'ZoomY', 'Rotation', 'AnchorPointX', 'AnchorPointY', 'Pitch', 'Yaw' property_value: The value to set fo…

Set a crop property for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify crop_type: The type of crop to set. Options: 'Left', 'Right', 'Top', 'Bottom' crop_value: The value to set for the crop (typically 0.0 to 1.0)

Set composite properties for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify composite_mode: Optional composite mode to set (e.g., 'Normal', 'Add', 'Multiply') opacity: Optional opacity value to set (0.0 to 1.0)

Set retiming properties for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify speed: Optional speed factor (e.g., 0.5 for 50%, 2.0 for 200%) process: Optional retime process. Options: 'NearestFrame', 'FrameBlend', 'OpticalFlow'

Set stabilization properties for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify enabled: Optional boolean to enable/disable stabilization method: Optional stabilization method. Options: 'Perspective', 'Similarity', 'Translation' strength: Optional strength value (0.0 …

Set audio properties for a timeline item. Args: timeline_item_id: The ID of the timeline item to modify volume: Optional volume level (usually 0.0 to 2.0, where 1.0 is unity gain) pan: Optional pan value (-1.0 to 1.0, where -1.0 is left, 0 is center, 1.0 is right) eq_enabled: Optional boolean to ena…

Add a keyframe at the specified frame for a timeline item property. Args: timeline_item_id: The ID of the timeline item to add keyframe to property_name: The name of the property to keyframe (e.g., 'Pan', 'ZoomX') frame: Frame position for the keyframe value: Value to set at the keyframe

Modify an existing keyframe by changing its value or frame position. Args: timeline_item_id: The ID of the timeline item property_name: The name of the property with keyframe frame: Current frame position of the keyframe to modify new_value: Optional new value for the keyframe new_frame: Optional ne…

Delete a keyframe at the specified frame for a timeline item property. Args: timeline_item_id: The ID of the timeline item property_name: The name of the property with keyframe to delete frame: Frame position of the keyframe to delete

Set the interpolation type for a keyframe. Args: timeline_item_id: The ID of the timeline item property_name: The name of the property with keyframe frame: Frame position of the keyframe interpolation_type: Type of interpolation. Options: 'Linear', 'Bezier', 'Ease-In', 'Ease-Out'

Enable keyframe mode for a timeline item. Args: timeline_item_id: The ID of the timeline item keyframe_mode: Keyframe mode to enable. Options: 'All', 'Color', 'Sizing'

Save a color preset from the specified clip. Args: clip_name: Name of the clip to save preset from (uses current clip if None) preset_name: Name to give the preset (uses clip name if None) album_name: Album to save the preset to (default: "DaVinci Resolve")

Apply a color preset to the specified clip. Args: preset_id: ID of the preset to apply (if known) preset_name: Name of the preset to apply (searches in album) clip_name: Name of the clip to apply preset to (uses current clip if None) album_name: Album containing the preset (default: "DaVinci Resolve…

Delete a color preset. Args: preset_id: ID of the preset to delete (if known) preset_name: Name of the preset to delete (searches in album) album_name: Album containing the preset (default: "DaVinci Resolve")

Create a new album for color presets. Args: album_name: Name for the new album

Delete a color preset album. Args: album_name: Name of the album to delete

Export a LUT from the current clip's grade. Args: clip_name: Name of the clip to export grade from (uses current clip if None) export_path: Path to save the LUT file (generated if None) lut_format: Format of the LUT. Options: 'Cube', 'Davinci', '3dl', 'Panasonic' lut_size: Size of the LUT. Options: …

Export all PowerGrade presets as LUT files. Args: export_dir: Directory to save the exported LUTs

Get human-readable help for a DaVinci Resolve API object. Args: object_type: Type of object to get help for ('resolve', 'project_manager', 'project', 'media_pool', 'timeline', 'media_storage')

Inspect a custom DaVinci Resolve API object by path. Args: object_path: Path to the object using dot notation (e.g., 'resolve.GetMediaStorage()')

Save the current UI layout as a preset. Args: preset_name: Name for the saved preset

Load a UI layout preset. Args: preset_name: Name of the preset to load

Export a layout preset to a file. Args: preset_name: Name of the preset to export export_path: Path to export the preset file to

Import a layout preset from a file. Args: import_path: Path to the preset file to import preset_name: Name to save the imported preset as (uses filename if None)

Delete a layout preset. Args: preset_name: Name of the preset to delete

Quit DaVinci Resolve application. Args: force: Whether to force quit even if unsaved changes (potentially dangerous) save_project: Whether to save the project before quitting

Restart DaVinci Resolve application. Args: wait_seconds: Seconds to wait between quit and restart

Open the Project Settings dialog in DaVinci Resolve.

Open the Preferences dialog in DaVinci Resolve.

Create a new cloud project. Args: project_name: Name for the new cloud project folder_path: Optional path for the cloud project folder

Import a project from DaVinci Resolve cloud. Args: cloud_id: Cloud ID or reference of the project to import project_name: Optional custom name for the imported project (uses original name if None)

Restore a project from DaVinci Resolve cloud. Args: cloud_id: Cloud ID or reference of the project to restore project_name: Optional custom name for the restored project (uses original name if None)

Export current or specified project to DaVinci Resolve cloud. Args: project_name: Optional name of project to export (uses current project if None)

Add a user to a cloud project with specified permissions. Args: cloud_id: Cloud ID of the project user_email: Email of the user to add permissions: Permission level (viewer, editor, admin)

Remove a user from a cloud project. Args: cloud_id: Cloud ID of the project user_email: Email of the user to remove

Set a project property value. Args: property_name: Name of the property to set property_value: Value to set for the property

Set timeline format (resolution and frame rate). Args: width: Timeline width in pixels height: Timeline height in pixels frame_rate: Timeline frame rate interlaced: Whether the timeline should use interlaced processing

Set SuperScale settings for the current project. Args: enabled: Whether SuperScale is enabled quality: SuperScale quality (0=Auto, 1=Better Quality, 2=Smoother)

Set color science mode for the current project. Args: mode: Color science mode ('YRGB', 'YRGB Color Managed', 'ACEScct', or numeric value)

Set timeline color space and gamma. Args: color_space: Timeline color space (e.g., 'Rec.709', 'DCI-P3 D65', 'Rec.2020') gamma: Timeline gamma (e.g., 'Rec.709 Gamma', 'Gamma 2.4')