DaVinci Resolve MCP Server
Provides comprehensive control over DaVinci Resolve's Scripting API, enabling AI agents to manage projects, timelines, media, color grading, rendering, Fusion compositions, Fairlight audio, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DaVinci Resolve MCP Server Show me the current timeline name and frame range"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DaVinci Resolve MCP Server
The most complete MCP server for DaVinci Resolve's Scripting API. Control projects, timelines, media, color grading, rendering, and more from any MCP-compatible client.
Features
212 tools across 15 domains (playback, project, media storage, media pool, clips, timelines, timeline items, render, color, Fusion, gallery, Fairlight, extensions, media analysis, grade exchange)
3 resources for quick context (
resolve://system,resolve://project,resolve://timeline)Complete API coverage of the DaVinci Resolve Scripting API (Phases 1-3)
Offline authoring & analysis (Phase 4): DCTL/Fuse/script installers, FFmpeg probe / frame extraction / QC, and ASC CDL grade exchange — all work on the free edition with Resolve closed, since they never touch the scripting bridge
Pydantic v2 models for type-safe inputs and outputs
Pagination for large clip and timeline item lists
Auto-reconnect if Resolve restarts or becomes unresponsive
Platform auto-detection for macOS, Windows, and Linux
Related MCP server: resolve-mcp
Requirements
DaVinci Resolve 18+
Studio for the scripting-bridge tools (the 189 live tools). External Python scripting is a Studio-only feature — on the free edition
scriptapp("Resolve")returnsNone, so live tools cannot connect.The free edition is enough for the 23 offline tools (extensions, media analysis, grade exchange), which only touch the filesystem and FFmpeg.
Python 3.11+
macOS, Windows, or Linux
Optional: FFmpeg on PATH (or
FFMPEG_BINARY/FFPROBE_BINARY) for the media analysis tools; a Whisper backend (faster-whisper) for transcription
Quick Start
Install from PyPI
pip install davinci-resolve-mcpOr with uv:
uv pip install davinci-resolve-mcpClaude Desktop Configuration
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"davinci-resolve": {
"command": "davinci-resolve-mcp"
}
}
}Then restart Claude Desktop. DaVinci Resolve must be running for tools to work.
See docs/CLAUDE_DESKTOP.md for a detailed setup guide with troubleshooting.
Development Setup
git clone https://github.com/luquimbo/davinci-resolve-mcp.git
cd davinci-resolve-mcp
uv sync --dev
uv run davinci-resolve-mcpVerify Your Setup
python scripts/check_resolve.pyThis prints Resolve version, current project, and timeline info to confirm the scripting bridge is working.
Tool Domains
Domain | Module | Tools | Description |
Playback |
| 7 | Page navigation, timecode, playhead position, version info |
Project |
| 21 | CRUD, settings, import/export (.drp), database folders, archive/restore, DB list |
Media Storage |
| 4 | Browse mounted volumes, list files, import to media pool |
Media Pool |
| 14 | Folder CRUD, clip management, timeline creation, metadata export |
Clips |
| 21 | Clip metadata, properties, colors, markers, flags, proxy, transcription, replace |
Timeline |
| 29 | CRUD, tracks, items, markers, export (AAF/EDL/FCPXML), compound/Fusion clips, scene detection, auto-subtitles, settings |
Timeline Items |
| 27 | Transform, crop, composite, color, markers, flags, takes, unique ID, stabilize, smart reframe, nodes |
Render |
| 14 | Formats, codecs, presets, job queue, start/stop, progress monitoring |
Color |
| 24 | Nodes, LUTs, CDL, grade versions, DRX application, color groups, node labels |
Fusion |
| 11 | Compositions CRUD, generators, titles, tool listing |
Gallery |
| 14 | Still albums, grab/import/export stills, PowerGrades, grade application |
Fairlight |
| 3 | Audio insertion, presets listing, preset application |
Extensions |
| 12 | Offline. Install/read/list/remove DCTLs, Fuses, and Fusion scripts on disk |
Media Analysis |
| 7 | Offline. FFmpeg probe, frame extraction, black/silence QC, Whisper transcription |
Grade Exchange |
| 4 | Offline. ASC CDL read/write ( |
Offline domains (extensions, media analysis, grade exchange) do not use the Resolve scripting bridge, so they run on the free edition and with Resolve closed. Everything else requires DaVinci Resolve Studio (external Python scripting is a Studio-only feature).
Resources (read-only context, no tool call needed):
URI | Description |
| Resolve version, product name, current page |
| Project name, timeline count, resolution, frame rate |
| Timeline name, frame range, track counts, timecode |
Architecture
src/davinci_resolve_mcp/
server.py FastMCP instance, registers all modules, CLI entry point
resolve_api.py Lazy singleton with platform auto-detection and health checks
platform_paths.py Cross-platform Resolve support-dir resolution (LUT/Fuses/Scripts)
models.py Pydantic models (CDLValues for ASC color correction)
constants.py Enums for pages, track types, clip colors, marker colors, export types
exceptions.py ResolveNotRunning, ResolveOperationFailed
tools/
playback.py Page navigation, timecode, version
project.py Project CRUD, settings, folders, import/export
media_storage.py Volume browsing, file listing, import
media_pool.py Folder CRUD, clip management, timeline creation
media_pool_item.py Clip metadata, properties, markers, flags
timeline.py Timeline CRUD, tracks, items, markers
timeline_item.py Transform, crop, composite, color, markers
render.py Formats, codecs, presets, jobs, rendering
color.py Nodes, LUTs, CDL, versions, groups
fusion.py Compositions, generators, titles
gallery.py Stills, albums, PowerGrades
fairlight.py Audio insertion, presets
extensions.py Offline DCTL/Fuse/script authoring (filesystem)
media_analysis.py Offline FFmpeg probe, frames, QC, transcription
cdl.py Offline ASC CDL read/write, .drx inspection
_offline_helpers.py Safe filenames + ffmpeg/ffprobe discovery
resources/
system_info.py resolve://system
project_info.py resolve://project
timeline_info.py resolve://timelineKey patterns:
Lazy singleton (
ResolveAPI): Connects to Resolve on first access, not at import time. AGetVersion()health check runs on every access to detect stale references and reconnect automatically.One module per domain: Each tool module exports a
register(mcp)function that decorates tool functions with@mcp.tool().Defensive error handling: Every API call catches
AttributeError(stale scripting bridge) and re-raises asResolveNotRunning. Version-specific methods are wrapped so missing APIs return clear errors instead of crashes.Pagination: Large lists (clips, timeline items) support
offsetandlimitparameters, returninghas_moreto signal additional pages.
See docs/ARCHITECTURE.md for the full design document.
Testing
# Unit tests (no Resolve needed)
uv run pytest
# Integration tests (requires Resolve running)
uv run pytest -m integrationScope
The 189 scripting-bridge tools (v0.1.0) cover core editing, color grading, Fusion compositions, gallery stills, Fairlight audio, timeline export, compound clips, transcription, takes management, scene detection, auto-subtitles, stabilization, smart reframe, project archival, and database management.
v0.2.0 adds 23 offline tools (212 total) that work on the free edition with Resolve closed: DCTL/Fuse/script authoring, FFmpeg-based media probe / frame extraction / black+silence QC / Whisper transcription, and ASC CDL (.cdl/.ccc) grade exchange plus .drx inspection.
Auto-Generated Tool Reference
Run the following to generate a complete tool reference from the registered MCP tools:
python scripts/generate_tool_docs.pyThis creates docs/TOOLS.md with every tool name, description, parameters, and return type grouped by domain.
Contributing
See CONTRIBUTING.md.
License
MIT. See LICENSE.
Available Tools
212 toolscdl_readARead-only
Read the first ASC CDL correction from a .cdl / .ccc file.
Inputs: file_path (required). Returns: object
cdl_read_allARead-only
Read every ASC CDL correction from a .ccc / .cdl file.
Inputs: file_path (required). Returns: result
cdl_writeA
Write a single ASC CDL correction to a .cdl file.
Emits a standard ColorDecisionList (ASC:CDL v1.01) that Resolve
and other tools can import as a primary grade.
Inputs: file_path (required), cc_id, power, slope, +2 more. Returns: result
clip_add_flagB
Add a flag of the given color to a clip.
Inputs: color (required), clip_name (required). Returns: result
clip_add_markerA
Add a marker to a media-pool clip at a given frame.
Inputs: color (required), frame_id (required), clip_name (required), name, +3 more. Returns: result
clip_clear_colorADestructive
Remove the label color from a clip, resetting it to the default.
Inputs: clip_name (required). Returns: result
clip_clear_flagsADestructive
Remove a specific flag color from a clip.
Inputs: color (required), clip_name (required). Returns: result
clip_clear_transcriptADestructive
Clear the transcript text from a clip.
Inputs: clip_name (required). Returns: result
clip_delete_markerB
Delete the marker at a specific frame on a clip.
Inputs: frame_id (required), clip_name (required). Returns: result
clip_get_colorARead-only
Return the label color assigned to a clip (e.g. "Orange", "Blue").
Inputs: clip_name (required). Returns: result
clip_get_flagsARead-only
Return all flag colors currently set on a clip.
Inputs: clip_name (required). Returns: result
clip_get_markersARead-only
Return all markers on a clip. Keys are frame IDs (as strings).
Inputs: clip_name (required). Returns: object
clip_get_metadataARead-only
Return all metadata fields for a clip as key-value pairs.
Inputs: clip_name (required). Returns: object
clip_get_nameARead-only
Return the display name of a media-pool clip.
Inputs: clip_name (required). Returns: result
clip_get_propertiesARead-only
Return all clip properties (Clip Name, Duration, FPS, etc.).
Inputs: clip_name (required). Returns: object
clip_get_transcriptARead-only
Get the transcript text for a clip.
Inputs: clip_name (required). Returns: result
clip_link_proxyB
Link an external proxy media file to a clip.
Inputs: clip_name (required), proxy_path (required). Returns: result
clip_replaceA
Replace a clip's media file with a new file.
Inputs: clip_name (required), new_file_path (required). Returns: result
clip_set_colorB
Set the label color on a clip.
Inputs: color (required), clip_name (required). Returns: result
clip_set_metadataA
Set a single metadata field on a clip.
Inputs: key (required), value (required), clip_name (required). Returns: result
clip_set_nameB
Rename a media-pool clip.
Inputs: new_name (required), clip_name (required). Returns: result
clip_set_propertyC
Set a single property on a clip.
Inputs: key (required), value (required), clip_name (required). Returns: result
clip_transcribe_audioB
Start audio transcription for a clip.
Requires DaVinci Resolve 19+ with speech-to-text support enabled.
Inputs: clip_name (required). Returns: result
clip_unlink_proxyADestructive
Remove proxy media link from a clip.
Inputs: clip_name (required). Returns: result
color_add_versionA
Create a new local grade version on a timeline item.
Inputs: item_name (required), version_name (required), track_type, track_index. Returns: result
color_apply_drxB
Apply a DaVinci Resolve grade preset (.drx) to one or more items.
Inputs: drx_path (required), grade_mode (required), item_names (required), track_type, +1 more. Returns: result
color_assign_to_groupB
Assign a timeline item to a color group.
Inputs: group_id (required), item_name (required), track_type, track_index. Returns: result
color_create_groupA
Create a new color group in the current project.
Inputs: group_name (required). Returns: result
color_delete_groupADestructive
Delete a color group from the current project by its ID.
Inputs: group_id (required). Returns: result
color_delete_versionADestructive
Delete a grade version from a timeline item.
Inputs: item_name (required), version_name (required), track_type, track_index, +1 more. Returns: result
color_export_lutB
Export the combined grade of a timeline item as a LUT file.
Inputs: lut_type (required), item_name (required), export_path (required), track_type, +1 more. Returns: result
color_get_cdlARead-only
Read the ASC CDL values from a timeline item's current node.
Inputs: item_name (required), track_type, track_index. Returns: object
color_get_current_versionARead-only
Return the name of the currently active grade version.
Inputs: item_name (required), track_type, track_index, version_type. Returns: result
color_get_group_listARead-only
List all color groups defined in the current project.
Returns: A list of dicts, each with at least "name" and "id" keys. Returns an empty list if the API is not supported or no groups are defined.
Inputs: no named parameters. Returns: result
color_get_lutARead-only
Return the LUT file path applied to a specific node, or empty string.
Inputs: item_name (required), node_index (required), track_type, track_index. Returns: result
color_get_node_labelARead-only
Get the label of a specific color correction node.
Inputs: item_name (required), node_index (required), track_type, track_index. Returns: result
color_get_num_nodesARead-only
Return the number of color correction nodes on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
color_get_version_countARead-only
Return the number of grade versions on a timeline item.
Inputs: item_name (required), track_type, track_index, version_type. Returns: result
color_get_versionsARead-only
List all grade version names on a timeline item.
Inputs: item_name (required), track_type, track_index, version_type. Returns: result
color_load_versionA
Load a specific grade version onto a timeline item, replacing current.
Unlike set_current_version (which switches), load_version replaces the current grade data with the contents of the named version.
Inputs: item_name (required), version_name (required), track_type, track_index, +1 more. Returns: result
color_remove_from_groupA
Remove a timeline item from a color group.
Inputs: group_id (required), item_name (required), track_type, track_index. Returns: result
color_rename_versionB
Rename a grade version on a timeline item.
Inputs: new_name (required), old_name (required), item_name (required), track_type, +2 more. Returns: result
color_reset_gradeADestructive
Reset a timeline item's grade to identity (neutral) CDL values.
Sets Slope=[1,1,1], Offset=[0,0,0], Power=[1,1,1], Saturation=1.0. This effectively neutralises the grade without removing nodes.
Inputs: item_name (required), track_type, track_index. Returns: result
color_set_cdlA
Set ASC CDL values on a timeline item's current node.
Inputs: cdl (required), item_name (required), track_type, track_index. Returns: result
color_set_current_versionC
Switch to a specific grade version on a timeline item.
Inputs: item_name (required), version_name (required), track_type, track_index, +1 more. Returns: result
color_set_lutA
Apply a LUT file to a specific node on a timeline item.
Inputs: lut_path (required), item_name (required), node_index (required), track_type, +1 more. Returns: result
color_set_node_enabledB
Enable or disable a specific color correction node.
Inputs: enabled (required), item_name (required), node_index (required), track_type, +1 more. Returns: result
color_set_node_labelA
Set the label on a specific color correction node.
Inputs: label (required), item_name (required), node_index (required), track_type, +1 more. Returns: result
drx_inspectARead-only
Inspect a Resolve .drx grade-exchange file (read-only).
The .drx schema is Resolve's proprietary node-graph grade format;
this reports its structure honestly rather than pretending to fully
decode it: root tag, direct child tags with counts, an approximate
node count, and any embedded ASC CDL SOP values found. Apply a
.drx inside a running Resolve with the timeline /
timeline_item grade tools (ApplyGradeFromDRX).
Inputs: file_path (required). Returns: object
extension_get_pathsARead-only
Return the resolved on-disk directories for each extension type.
Useful to confirm where DCTLs, Fuses, and Scripts will be written on
this machine. Paths honour the RESOLVE_*_DIR environment
overrides. The directories may not exist yet — a write creates them.
Inputs: no named parameters. Returns: object
extension_list_dctlARead-only
List installed DCTL files (*.dctl) in the Resolve LUT directory.
Inputs: no named parameters. Returns: result
extension_list_fusesARead-only
List installed Fuse files (*.fuse) in the Fusion Fuses directory.
Inputs: no named parameters. Returns: result
extension_list_scriptsARead-only
List scripts (*.lua / *.py) in a Fusion Scripts subfolder.
Inputs: category. Returns: result
extension_read_dctlARead-only
Return the source of an installed DCTL file.
Inputs: name (required). Returns: result
extension_read_scriptBRead-only
Return the source of an installed script in a Scripts subfolder.
Inputs: name (required), category. Returns: result
extension_remove_dctlA
Delete an installed DCTL file. Returns True if a file was removed.
Inputs: name (required). Returns: result
extension_remove_fuseB
Delete an installed Fuse file. Returns True if a file was removed.
Inputs: name (required). Returns: result
extension_remove_scriptB
Delete an installed script. Returns True if a file was removed.
Inputs: name (required), category. Returns: result
extension_write_dctlA
Install a DCTL by writing its source into the LUT directory.
Inputs: code (required), name (required), overwrite. Returns: result
extension_write_fuseA
Install a Fuse by writing its Lua source into the Fuses directory.
Inputs: code (required), name (required), overwrite. Returns: result
extension_write_scriptB
Install a Fusion/Resolve script under a per-page Scripts subfolder.
Inputs: code (required), name (required), category, overwrite. Returns: result
fairlight_apply_presetA
Apply a Fairlight audio effect preset to an audio track.
Inputs: preset_name (required), track_index. Returns: result
fairlight_get_presetsARead-only
List available Fairlight audio effect presets.
Returns preset names as strings. Returns an empty list if the Fairlight preset API is not available in this Resolve version.
Inputs: no named parameters. Returns: result
fairlight_insert_audioA
Import an audio file and insert it into the timeline on an audio track.
The file is first imported into the Media Pool, then appended to the current timeline. Because the scripting API has limited control over audio-track targeting, the clip is appended using the standard AppendToTimeline method.
Inputs: file_path (required), track_index. Returns: result
fusion_add_compA
Add a new Fusion composition to the timeline item under the playhead.
This operates on the currently selected video item (the clip at the playhead position). Use playback tools to position the playhead first.
Returns: True if a new composition was added.
Inputs: no named parameters. Returns: result
fusion_delete_compADestructive
Delete a Fusion composition from a timeline item by name.
Inputs: comp_name (required), item_name (required), track_type, track_index. Returns: result
fusion_export_compA
Export a Fusion composition to a .comp file on disk.
Inputs: comp_name (required), item_name (required), export_path (required), track_type, +1 more. Returns: result
fusion_get_compARead-only
Return basic information about a Fusion composition by name.
Inputs: comp_name (required), item_name (required), track_type, track_index. Returns: result
fusion_get_comp_countARead-only
Return the number of Fusion compositions on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
fusion_get_comp_namesARead-only
List the names of all Fusion compositions on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
fusion_get_tool_listARead-only
List all Fusion tools inside a specific composition.
Inputs: comp_name (required), item_name (required), track_type, track_index. Returns: result
fusion_import_compB
Import a Fusion composition file (.comp) onto a timeline item.
Inputs: comp_path (required), item_name (required), track_type, track_index. Returns: result
fusion_insert_generatorA
Insert a Fusion generator into the current timeline.
The generator is appended at the end of the timeline via the Media Pool's AppendToTimeline API with mediaType "generator".
Inputs: generator_name (required). Returns: result
fusion_insert_titleA
Insert a Fusion title into the current timeline.
The title is appended at the end of the timeline via the Media Pool's AppendToTimeline API with mediaType "title".
Inputs: title_name (required). Returns: result
fusion_rename_compB
Rename a Fusion composition on a timeline item.
Inputs: new_name (required), old_name (required), item_name (required), track_type, +1 more. Returns: result
gallery_apply_grade_from_stillB
Apply the color grade from a gallery still to timeline items.
Inputs: item_names (required), still_index (required), album_name, track_type, +1 more. Returns: result
gallery_create_albumA
Create a new still album in the Gallery.
Inputs: name (required). Returns: result
gallery_delete_albumADestructive
Delete a still album from the Gallery.
Inputs: album_name (required). Returns: result
gallery_delete_stillsADestructive
Delete stills from a Gallery album by index.
Inputs: still_indices (required), album_name. Returns: result
gallery_export_stillsB
Export stills from a Gallery album to disk.
Inputs: export_path (required), still_indices (required), album_name. Returns: result
gallery_get_albumsARead-only
List the names of all still albums in the Gallery.
Returns album names as strings. Requires an open project.
Inputs: no named parameters. Returns: result
gallery_get_current_albumARead-only
Return the name of the currently active still album.
Returns an empty string if no album is currently selected.
Inputs: no named parameters. Returns: result
gallery_get_powergrade_albumsARead-only
List the names of all PowerGrade albums in the Gallery.
PowerGrade albums contain grades that persist across projects. This method may not be available in all Resolve versions.
Inputs: no named parameters. Returns: result
gallery_get_powergrade_stillsARead-only
List stills in a PowerGrade album.
Inputs: album_name (required). Returns: result
gallery_get_stillsBRead-only
List stills in a Gallery album.
Inputs: album_name. Returns: result
gallery_grab_stillA
Grab a still from the current viewer into the current album.
Captures a snapshot of whatever is currently displayed in the Resolve viewer and adds it to the current still album. Equivalent to the "Grab Still" button in the Color page.
Returns True if the grab succeeded. This may require being on the Color page with a valid viewer image.
Inputs: no named parameters. Returns: result
gallery_import_stillsB
Import still image files into a Gallery album.
Inputs: file_paths (required), album_name. Returns: result
gallery_set_current_albumA
Switch the active still album to the one matching album_name.
Inputs: album_name (required). Returns: result
gallery_set_current_powergrade_albumA
Switch the active PowerGrade album to the one matching album_name.
Inputs: album_name (required). Returns: result
item_add_flagA
Add a flag of the given color to a timeline item.
Inputs: color (required), item_name (required), track_type, track_index. Returns: result
item_add_markerA
Add a marker to a timeline item at a given frame offset.
Inputs: color (required), frame_id (required), item_name (required), name, +5 more. Returns: result
item_add_nodeA
Add a color correction node to the timeline item's node graph.
Inputs: item_name (required), track_type, track_index. Returns: result
item_delete_markerADestructive
Delete the marker at a specific frame offset on a timeline item.
Inputs: frame_id (required), item_name (required), track_type, track_index. Returns: result
item_delete_take_by_indexADestructive
Delete a take at the given index on a timeline item.
Inputs: item_name (required), take_index (required), track_type, track_index. Returns: result
item_finalize_takeA
Finalize the current take on a timeline item.
This commits the current take, removing other take options.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_colorARead-only
Return the label color assigned to a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_durationARead-only
Return the duration of a timeline item in frames.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_flagsARead-only
Return all flag colors currently set on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_linked_itemsARead-only
Return items linked to this timeline item (e.g. audio for a video clip).
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_markersARead-only
Return all markers on a timeline item. Keys are frame offsets.
Inputs: item_name (required), track_type, track_index. Returns: object
item_get_media_pool_itemARead-only
Return the source media-pool clip for a timeline item, if available.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_nameARead-only
Return the display name of a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_propertiesARead-only
Return all properties of a timeline item as key-value pairs.
Inputs: item_name (required), track_type, track_index. Returns: object
item_get_start_endARead-only
Return the start frame, end frame, and duration of a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: object
item_get_take_by_indexBRead-only
Return info about a take at the given 1-based index.
Inputs: item_name (required), take_index (required), track_type, track_index. Returns: result
item_get_takes_countARead-only
Return the number of takes on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
item_get_unique_idARead-only
Return the unique identifier for a timeline item.
This ID is stable across project saves and can be used to reference a specific item programmatically.
Inputs: item_name (required), track_type, track_index. Returns: result
item_select_take_by_indexB
Select a specific take on a timeline item.
Inputs: item_name (required), take_index (required), track_type, track_index. Returns: result
item_set_colorA
Set the label color on a timeline item.
Inputs: color (required), item_name (required), track_type, track_index. Returns: result
item_set_compositeA
Set composite mode and/or opacity on a timeline item.
Inputs: item_name (required), mode, opacity, track_type, +1 more. Returns: result
item_set_cropA
Set crop values on a timeline item.
Only non-None parameters are applied; the rest remain unchanged.
Inputs: item_name (required), top, left, right, +3 more. Returns: result
item_set_enabledA
Enable or disable a timeline item (muted/unmuted).
Inputs: enabled (required), item_name (required), track_type, track_index. Returns: result
item_set_propertyC
Set a single property on a timeline item.
Inputs: key (required), value (required), item_name (required), track_type, +1 more. Returns: result
item_set_transformA
Set transform properties (zoom, position, rotation, anchor) on an item.
Only non-None parameters are applied; the rest remain unchanged.
Inputs: item_name (required), zoom_x, zoom_y, anchor_x, +6 more. Returns: result
item_smart_reframeC
Apply smart reframe to a timeline item.
Inputs: item_name (required), track_type, track_index, target_ratio, +1 more. Returns: result
item_stabilizeB
Run stabilization analysis on a timeline item.
Inputs: item_name (required), track_type, track_index. Returns: result
media_detect_blackARead-only
Detect black-frame spans (leader, slate gaps, missing media).
Runs ffmpeg's blackdetect filter. Useful for locating a slate,
2-pop leader, or accidental black holes before conform.
Inputs: file_path (required), threshold, min_duration_sec. Returns: result
media_detect_silenceARead-only
Detect silent spans in the audio (dead air, sync gaps).
Runs ffmpeg's silencedetect filter.
Inputs: file_path (required), noise_db, min_duration_sec. Returns: result
media_extract_frameA
Extract a single frame at a timestamp to an image file.
The source is never modified — the frame is written to
output_path. A vision-capable host can then read the still to
describe or QC the shot.
Inputs: file_path (required), output_path (required), timestamp_sec (required). Returns: result
media_extract_framesA
Extract multiple frames to an output directory for review.
Provide EITHER a count of evenly-spaced frames across the clip's
duration (default), OR an fps sampling rate — fps wins when
given. Source media is never modified.
Inputs: file_path (required), output_dir (required), fps, count. Returns: result
media_pool_create_folderA
Create a new subfolder inside the current Media Pool folder.
Inputs: name (required). Returns: result
media_pool_create_timelineA
Create a new empty timeline in the current Media Pool folder.
Inputs: name (required). Returns: result
media_pool_create_timeline_from_clipsA
Create a new timeline populated with specific clips from the current folder.
Inputs: name (required), clip_names (required). Returns: result
media_pool_delete_clipsADestructive
Delete clips from the current Media Pool folder by name.
Inputs: clip_names (required). Returns: result
media_pool_delete_foldersADestructive
Delete Media Pool subfolders by name.
Inputs: folder_names (required). Returns: result
media_pool_export_metadataB
Export metadata of all clips in the current folder to a CSV file.
Inputs: file_path (required). Returns: result
media_pool_get_clipsARead-only
List clips in the current Media Pool folder with pagination.
Inputs: limit, offset. Returns: object
media_pool_get_current_folderARead-only
Get the name of the currently selected Media Pool folder.
Inputs: no named parameters. Returns: result
media_pool_get_root_folderARead-only
Get the name of the Media Pool's root folder.
Every project has exactly one root folder (usually named 'Master').
Inputs: no named parameters. Returns: result
media_pool_get_subfoldersARead-only
List the names of all subfolders in the current Media Pool folder.
Inputs: no named parameters. Returns: result
media_pool_import_mediaB
Import media files from disk into the current Media Pool folder.
Inputs: file_paths (required). Returns: result
media_pool_move_clipsA
Move clips from the current folder to a different Media Pool folder.
Inputs: clip_names (required), target_folder_name (required). Returns: result
media_pool_relink_clipsA
Relink offline clips to media files in a new folder.
Inputs: clip_names (required), new_folder_path (required). Returns: result
media_pool_set_current_folderB
Navigate into a Media Pool folder by name.
Inputs: folder_name (required). Returns: result
media_probeBRead-only
Return a concise summary of a media file (container + key streams).
Inputs: file_path (required). Returns: object
media_streamsARead-only
Return the full ffprobe payload (all format + stream fields).
Inputs: file_path (required). Returns: object
media_transcribeB
Transcribe speech in a media file with Whisper (offline, if installed).
Tries faster_whisper first, then openai-whisper. If neither
is installed, raises with a clear pip install hint rather than
failing opaquely — this keeps Whisper an optional dependency.
Inputs: file_path (required), model, language. Returns: object
playback_get_current_itemARead-only
Return info about the timeline item under the playhead, or None.
Returns a dict with keys: name, start, end, duration. Returns None if no item is under the playhead or no timeline is open.
Inputs: no named parameters. Returns: result
playback_get_pageARead-only
Return the name of the currently active Resolve page.
Possible values: "media", "cut", "edit", "fusion", "color", "fairlight", "deliver", or "" if Resolve cannot determine the page.
Inputs: no named parameters. Returns: result
playback_get_timecodeARead-only
Return the current playhead timecode (e.g. "01:00:05:12").
Requires an open project with at least one timeline.
Inputs: no named parameters. Returns: result
playback_open_pageB
Switch Resolve to a different workspace page.
Inputs: page (required). Returns: result
playback_set_timecodeA
Move the playhead to a specific timecode position.
Inputs: timecode (required). Returns: result
project_archiveB
Archive a project to a .dra file.
The project must NOT be currently open.
Inputs: name (required), file_path (required), with_stills_and_luts. Returns: result
project_closeA
Close the current project (saves automatically before closing).
Returns: True if the project was closed successfully.
Inputs: no named parameters. Returns: result
project_createA
Create a new project and open it immediately.
Inputs: name (required). Returns: result
project_deleteADestructive
Delete a project by name. The project must NOT be currently open.
Inputs: name (required). Returns: result
project_exportB
Export the current project to a .drp file.
Inputs: file_path (required), with_stills_and_luts. Returns: result
project_folder_createA
Create a new folder in the current database folder.
Inputs: folder_name (required). Returns: result
project_folder_deleteADestructive
Delete a folder from the current database folder.
The folder must be empty (no projects inside).
Inputs: folder_name (required). Returns: result
project_folder_goto_parentA
Navigate up one level in the project database folder hierarchy.
Returns: True if navigation succeeded. False if already at root.
Inputs: no named parameters. Returns: result
project_folder_goto_rootA
Navigate to the root of the project database.
Returns: True if navigation to root succeeded.
Inputs: no named parameters. Returns: result
project_folder_listARead-only
List sub-folders in the current database folder.
Returns: A list of folder name strings.
Inputs: no named parameters. Returns: result
project_folder_openC
Navigate into a sub-folder within the project database.
Inputs: folder_name (required). Returns: result
project_get_currentARead-only
Return basic info about the currently open project.
Returns: A dict with keys: name (str), timeline_count (int).
Inputs: no named parameters. Returns: object
project_get_databaseARead-only
Return info about the current project database.
Returns: A dict with database info (DbType, DbName, IpAddress if remote).
Inputs: no named parameters. Returns: object
project_get_database_listARead-only
List all available project databases.
Returns: A list of dicts, each with keys like "DbType", "DbName", and optionally "IpAddress" for remote databases.
Inputs: no named parameters. Returns: result
project_get_settingARead-only
Read a single project setting by its key.
Inputs: key (required). Returns: result
project_importA
Import a .drp project file into the current database folder.
Inputs: file_path (required). Returns: result
project_listARead-only
List all project names in the current database folder.
Returns an alphabetically-ordered list of project name strings.
Inputs: no named parameters. Returns: result
project_openA
Open an existing project by name.
Inputs: name (required). Returns: result
project_restore_archiveB
Restore a project from a .dra archive file.
Inputs: file_path (required). Returns: result
project_saveA
Save the current project.
Returns: True if the save succeeded.
Inputs: no named parameters. Returns: result
project_set_settingC
Write a project setting.
Inputs: key (required), value (required). Returns: result
render_add_jobA
Add the current timeline to the render queue with current settings.
The timeline must be set (Deliver page) and render settings must be configured before calling this tool.
Returns: The job ID string for the newly queued render job.
Inputs: no named parameters. Returns: result
render_delete_all_jobsADestructive
Delete all render jobs from the queue.
Returns: True if all jobs were deleted successfully.
Inputs: no named parameters. Returns: result
render_delete_jobADestructive
Delete a specific render job from the queue.
Inputs: job_id (required). Returns: result
render_get_codecsARead-only
Return available codecs for a given render format.
Inputs: format_name (required). Returns: object
render_get_format_and_codecARead-only
Return the currently selected render format and codec.
Returns: A dict with keys "format" and "codec" (both strings).
Inputs: no named parameters. Returns: object
render_get_formatsARead-only
Return available render formats as {formatName: description}.
Use the format names as input for render_get_codecs() or render_set_format_and_codec().
Inputs: no named parameters. Returns: object
render_get_jobsARead-only
Return all render jobs in the queue with their current status.
Returns: A list of dicts, each with keys: job_id, status, timeline_name, target_dir, output_filename.
Inputs: no named parameters. Returns: result
render_get_presetsARead-only
List all saved render preset names.
Returns: A list of preset name strings that can be passed to render_load_preset().
Inputs: no named parameters. Returns: result
render_get_statusARead-only
Return the render progress for a specific job.
Inputs: job_id (required). Returns: object
render_load_presetA
Load a render preset by name, applying its settings.
Inputs: preset_name (required). Returns: result
render_set_format_and_codecB
Set the render format and codec.
Inputs: codec_name (required), format_name (required). Returns: result
render_set_settingsC
Apply render settings from a dictionary.
Inputs: settings (required). Returns: result
render_startA
Start rendering queued jobs.
Inputs: job_ids, is_interactive. Returns: result
render_stopA
Stop the currently running render.
Returns: True if rendering was stopped. Also returns True if no render was in progress (idempotent).
Inputs: no named parameters. Returns: result
resolve_get_productARead-only
Return the Resolve product name.
Typically "DaVinci Resolve" (free) or "DaVinci Resolve Studio" (paid).
Inputs: no named parameters. Returns: result
resolve_get_versionARead-only
Return the DaVinci Resolve version as a dotted string (e.g. "19.1.2").
The underlying API may return a list of version components or a string; this tool always returns a single joined string.
Inputs: no named parameters. Returns: result
storage_get_filesARead-only
List media files in a storage folder.
Inputs: folder_path (required). Returns: result
storage_get_subfoldersBRead-only
List subfolders inside a media storage path.
Inputs: volume_path (required). Returns: result
storage_get_volumesARead-only
List all mounted media storage volumes visible to DaVinci Resolve.
Returns the volume paths (e.g. '/' on macOS, 'C:' on Windows, or NAS mount points) that appear in the Media page's storage panel.
Inputs: no named parameters. Returns: result
storage_import_to_poolB
Import files from media storage into the current project's media pool.
Inputs: file_paths (required). Returns: result
timeline_add_markerA
Add a marker to the current timeline at a specific frame.
Inputs: color (required), frame_id (required), name, note, +2 more. Returns: result
timeline_add_trackB
Add one or more tracks to the current timeline.
Inputs: track_type (required), count. Returns: result
timeline_append_clipsA
Append media pool clips to the end of the current timeline.
Searches the media pool's current folder for clips matching the given names, then appends them in order.
Inputs: clip_names (required). Returns: result
timeline_create_compound_clipB
Create a compound clip from timeline items on a specific track.
A compound clip merges multiple timeline items into one editable unit.
Inputs: item_names (required), clip_name, track_type, track_index. Returns: result
timeline_create_fusion_clipA
Create a Fusion clip from timeline items on a specific track.
A Fusion clip wraps selected items into a single Fusion composition that can be opened and edited in the Fusion page.
Inputs: item_names (required), track_type, track_index. Returns: result
timeline_create_subtitles_from_audioA
Auto-generate subtitles from audio in the current timeline.
Uses Resolve's built-in speech-to-text to create subtitle track items. Requires DaVinci Resolve 18.5 or later.
Returns: True if subtitles were generated successfully.
Inputs: no named parameters. Returns: result
timeline_delete_clipsADestructive
Delete timeline items by name from a specific track.
Inputs: item_names (required), track_type, track_index. Returns: result
timeline_delete_markerB
Delete a marker at a specific frame on the current timeline.
Inputs: frame_id (required). Returns: result
timeline_delete_trackADestructive
Delete a track from the current timeline.
Inputs: track_type (required), track_index (required). Returns: result
timeline_detect_scene_cutsARead-only
Detect scene cuts in the current timeline.
Analyzes the video content and returns frame numbers where scene transitions were detected. Requires DaVinci Resolve 18.5 or later.
Returns: A list of frame numbers where cuts were detected.
Inputs: no named parameters. Returns: result
timeline_duplicateA
Duplicate the current timeline.
Returns: The name of the newly created timeline, or None if duplication failed.
Inputs: no named parameters. Returns: result
timeline_exportA
Export the current timeline to a file (AAF, EDL, FCPXML, etc.).
Inputs: file_path (required), export_type, export_subtype. Returns: result
timeline_get_by_indexARead-only
Return info about a timeline at the given 1-based index.
Inputs: index (required). Returns: result
timeline_get_countARead-only
Return the number of timelines in the current project.
Inputs: no named parameters. Returns: result
timeline_get_currentARead-only
Return info about the current timeline, or None if no timeline is open.
Returns a dict with keys: name, start_frame, end_frame, video_tracks, audio_tracks, start_timecode.
Inputs: no named parameters. Returns: result
timeline_get_end_frameARead-only
Return the end frame number of the current timeline.
Inputs: no named parameters. Returns: result
timeline_get_items_in_trackARead-only
List timeline items on a specific track with pagination.
Inputs: track_type (required), track_index (required), limit, offset. Returns: object
timeline_get_markersARead-only
Return all markers on the current timeline.
Returns: A dict mapping frame numbers (as string keys) to marker info dicts. Each marker dict contains: color, duration, note, name, customData. Returns an empty dict if no markers exist or no timeline is open.
Inputs: no named parameters. Returns: object
timeline_get_nameARead-only
Return the name of the current timeline.
Raises an error if no timeline is open.
Inputs: no named parameters. Returns: result
timeline_get_settingBRead-only
Read a timeline-specific setting by key.
Inputs: key (required). Returns: result
timeline_get_start_frameARead-only
Return the start frame number of the current timeline.
Inputs: no named parameters. Returns: result
timeline_get_track_countARead-only
Return the number of tracks of the given type in the current timeline.
Inputs: track_type. Returns: result
timeline_get_track_nameARead-only
Return the name of a specific track in the current timeline.
Inputs: track_type (required), track_index (required). Returns: result
timeline_set_currentB
Set the current timeline by name.
Inputs: name (required). Returns: result
timeline_set_nameB
Rename the current timeline.
Inputs: name (required). Returns: result
timeline_set_settingC
Write a timeline-specific setting.
Inputs: key (required), value (required). Returns: result
timeline_set_track_enabledB
Enable or disable a track in the current timeline.
Inputs: enabled (required), track_type (required), track_index (required). Returns: result
timeline_set_track_lockedB
Lock or unlock a track in the current timeline.
Inputs: locked (required), track_type (required), track_index (required). Returns: result
timeline_set_track_nameA
Rename a track in the current timeline.
Inputs: name (required), track_type (required), track_index (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 212 tools
Tool names use clear resource prefixes (project_, timeline_, clip_, item_, render_, media_pool_) that make most purposes obvious. A few pairs blur together—clip_get_metadata vs clip_get_properties, clip_transcribe_audio vs media_transcribe, and storage_import_to_pool vs media_pool_import_media—but the descriptions clarify the distinctions.
The set is uniformly snake_case with verb_noun structure and heavy resource prefixes, so naming is predictable. Minor inconsistencies like list/get/read interchange, project_folder_goto_parent vs project_folder_goto_root, and standalone media_probe/media_streams/cdl_read keep it from being perfect.
212 tools is far beyond the 3–15 well-scoped range and would overwhelm an agent's context and tool-selection process. Even for DaVinci Resolve's broad surface, many atomic operations could be grouped into parameterized tools (e.g. one marker tool with an action parameter).
Coverage is remarkably extensive: project lifecycle, media pool, clips, timelines, items, color, Fusion, Fairlight, gallery, render, extensions, and media analysis are all represented. It misses a few useful controls such as undo/redo, arbitrary timeline-insert positioning, and deeper Fairlight mixing operations, but there are no major dead ends.
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes 20 tools for project, media, render, and timeline control in DaVinci Resolve 18+ via stdio MCP, enabling AI agents to operate the software through natural language.20 PyPI54MIT
- AlicenseNot gradedqualityCmaintenanceComprehensive MCP server for DaVinci Resolve with 295+ tools to control projects, timelines, editing, color grading, rendering, and more via natural language.113 PyPI7MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that exposes the complete DaVinci Resolve scripting API, enabling AI assistants to control DaVinci Resolve programmatically with over 440 tools for project management, timeline editing, color grading, rendering, and more.28MIT
- AlicenseBqualityAmaintenanceLets AI clients inspect and control DaVinci Resolve projects via MCP tools.46266 npm66MIT