Skip to main content
Glama
DaVinci Resolve MCP Server

DaVinci Resolve MCP Server

by luquimbo

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") returns None, 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-mcp

Or with uv:

uv pip install davinci-resolve-mcp

Claude 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-mcp

Verify Your Setup

python scripts/check_resolve.py

This prints Resolve version, current project, and timeline info to confirm the scripting bridge is working.

Tool Domains

Domain

Module

Tools

Description

Playback

playback

7

Page navigation, timecode, playhead position, version info

Project

project

21

CRUD, settings, import/export (.drp), database folders, archive/restore, DB list

Media Storage

media_storage

4

Browse mounted volumes, list files, import to media pool

Media Pool

media_pool

14

Folder CRUD, clip management, timeline creation, metadata export

Clips

media_pool_item

21

Clip metadata, properties, colors, markers, flags, proxy, transcription, replace

Timeline

timeline

29

CRUD, tracks, items, markers, export (AAF/EDL/FCPXML), compound/Fusion clips, scene detection, auto-subtitles, settings

Timeline Items

timeline_item

27

Transform, crop, composite, color, markers, flags, takes, unique ID, stabilize, smart reframe, nodes

Render

render

14

Formats, codecs, presets, job queue, start/stop, progress monitoring

Color

color

24

Nodes, LUTs, CDL, grade versions, DRX application, color groups, node labels

Fusion

fusion

11

Compositions CRUD, generators, titles, tool listing

Gallery

gallery

14

Still albums, grab/import/export stills, PowerGrades, grade application

Fairlight

fairlight

3

Audio insertion, presets listing, preset application

Extensions

extensions

12

Offline. Install/read/list/remove DCTLs, Fuses, and Fusion scripts on disk

Media Analysis

media_analysis

7

Offline. FFmpeg probe, frame extraction, black/silence QC, Whisper transcription

Grade Exchange

cdl

4

Offline. ASC CDL read/write (.cdl/.ccc) and .drx grade inspection

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://system

Resolve version, product name, current page

resolve://project

Project name, timeline count, resolution, frame rate

resolve://timeline

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://timeline

Key patterns:

  • Lazy singleton (ResolveAPI): Connects to Resolve on first access, not at import time. A GetVersion() 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 as ResolveNotRunning. Version-specific methods are wrapped so missing APIs return clear errors instead of crashes.

  • Pagination: Large lists (clips, timeline items) support offset and limit parameters, returning has_more to 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 integration

Scope

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.py

This 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 tools
cdl_readA
Read-only

Read the first ASC CDL correction from a .cdl / .ccc file.

Inputs: file_path (required). Returns: object

cdl_read_allA
Read-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_colorA
Destructive

Remove the label color from a clip, resetting it to the default.

Inputs: clip_name (required). Returns: result

clip_clear_flagsA
Destructive

Remove a specific flag color from a clip.

Inputs: color (required), clip_name (required). Returns: result

clip_clear_transcriptA
Destructive

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_colorA
Read-only

Return the label color assigned to a clip (e.g. "Orange", "Blue").

Inputs: clip_name (required). Returns: result

clip_get_flagsA
Read-only

Return all flag colors currently set on a clip.

Inputs: clip_name (required). Returns: result

clip_get_markersA
Read-only

Return all markers on a clip. Keys are frame IDs (as strings).

Inputs: clip_name (required). Returns: object

clip_get_metadataA
Read-only

Return all metadata fields for a clip as key-value pairs.

Inputs: clip_name (required). Returns: object

clip_get_nameA
Read-only

Return the display name of a media-pool clip.

Inputs: clip_name (required). Returns: result

clip_get_propertiesA
Read-only

Return all clip properties (Clip Name, Duration, FPS, etc.).

Inputs: clip_name (required). Returns: object

clip_get_transcriptA
Read-only

Get the transcript text for a clip.

Inputs: clip_name (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

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_groupA
Destructive

Delete a color group from the current project by its ID.

Inputs: group_id (required). Returns: result

color_delete_versionA
Destructive

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_cdlA
Read-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_versionA
Read-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_listA
Read-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_lutA
Read-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_labelA
Read-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_nodesA
Read-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_countA
Read-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_versionsA
Read-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_gradeA
Destructive

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_inspectA
Read-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_pathsA
Read-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_dctlA
Read-only

List installed DCTL files (*.dctl) in the Resolve LUT directory.

Inputs: no named parameters. Returns: result

extension_list_fusesA
Read-only

List installed Fuse files (*.fuse) in the Fusion Fuses directory.

Inputs: no named parameters. Returns: result

extension_list_scriptsA
Read-only

List scripts (*.lua / *.py) in a Fusion Scripts subfolder.

Inputs: category. Returns: result

extension_read_dctlA
Read-only

Return the source of an installed DCTL file.

Inputs: name (required). Returns: result

extension_read_scriptB
Read-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_presetsA
Read-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_compA
Destructive

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_compA
Read-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_countA
Read-only

Return the number of Fusion compositions on a timeline item.

Inputs: item_name (required), track_type, track_index. Returns: result

fusion_get_comp_namesA
Read-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_listA
Read-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

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_markerA
Destructive

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_indexA
Destructive

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_colorA
Read-only

Return the label color assigned to a timeline item.

Inputs: item_name (required), track_type, track_index. Returns: result

item_get_durationA
Read-only

Return the duration of a timeline item in frames.

Inputs: item_name (required), track_type, track_index. Returns: result

item_get_flagsA
Read-only

Return all flag colors currently set on a timeline item.

Inputs: item_name (required), track_type, track_index. Returns: result

item_get_linked_itemsA
Read-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_markersA
Read-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_itemA
Read-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_nameA
Read-only

Return the display name of a timeline item.

Inputs: item_name (required), track_type, track_index. Returns: result

item_get_propertiesA
Read-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_endA
Read-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_indexB
Read-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_countA
Read-only

Return the number of takes on a timeline item.

Inputs: item_name (required), track_type, track_index. Returns: result

item_get_unique_idA
Read-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_blackA
Read-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_silenceA
Read-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_clipsA
Destructive

Delete clips from the current Media Pool folder by name.

Inputs: clip_names (required). Returns: result

media_pool_delete_foldersA
Destructive

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_clipsA
Read-only

List clips in the current Media Pool folder with pagination.

Inputs: limit, offset. Returns: object

media_pool_get_current_folderA
Read-only

Get the name of the currently selected Media Pool folder.

Inputs: no named parameters. Returns: result

media_pool_get_root_folderA
Read-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_subfoldersA
Read-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_set_current_folderB

Navigate into a Media Pool folder by name.

Inputs: folder_name (required). Returns: result

media_probeB
Read-only

Return a concise summary of a media file (container + key streams).

Inputs: file_path (required). Returns: object

media_streamsA
Read-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_itemA
Read-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_pageA
Read-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_timecodeA
Read-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_deleteA
Destructive

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_deleteA
Destructive

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_listA
Read-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_currentA
Read-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_databaseA
Read-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_listA
Read-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_settingA
Read-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_listA
Read-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_jobsA
Destructive

Delete all render jobs from the queue.

Returns: True if all jobs were deleted successfully.

Inputs: no named parameters. Returns: result

render_delete_jobA
Destructive

Delete a specific render job from the queue.

Inputs: job_id (required). Returns: result

render_get_codecsA
Read-only

Return available codecs for a given render format.

Inputs: format_name (required). Returns: object

render_get_format_and_codecA
Read-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_formatsA
Read-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_jobsA
Read-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_presetsA
Read-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_statusA
Read-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_productA
Read-only

Return the Resolve product name.

Typically "DaVinci Resolve" (free) or "DaVinci Resolve Studio" (paid).

Inputs: no named parameters. Returns: result

resolve_get_versionA
Read-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_filesA
Read-only

List media files in a storage folder.

Inputs: folder_path (required). Returns: result

storage_get_subfoldersB
Read-only

List subfolders inside a media storage path.

Inputs: volume_path (required). Returns: result

storage_get_volumesA
Read-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_clipsA
Destructive

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_trackA
Destructive

Delete a track from the current timeline.

Inputs: track_type (required), track_index (required). Returns: result

timeline_detect_scene_cutsA
Read-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_indexA
Read-only

Return info about a timeline at the given 1-based index.

Inputs: index (required). Returns: result

timeline_get_countA
Read-only

Return the number of timelines in the current project.

Inputs: no named parameters. Returns: result

timeline_get_currentA
Read-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_frameA
Read-only

Return the end frame number of the current timeline.

Inputs: no named parameters. Returns: result

timeline_get_items_in_trackA
Read-only

List timeline items on a specific track with pagination.

Inputs: track_type (required), track_index (required), limit, offset. Returns: object

timeline_get_markersA
Read-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_nameA
Read-only

Return the name of the current timeline.

Raises an error if no timeline is open.

Inputs: no named parameters. Returns: result

timeline_get_settingB
Read-only

Read a timeline-specific setting by key.

Inputs: key (required). Returns: result

timeline_get_start_frameA
Read-only

Return the start frame number of the current timeline.

Inputs: no named parameters. Returns: result

timeline_get_track_countA
Read-only

Return the number of tracks of the given type in the current timeline.

Inputs: track_type. Returns: result

timeline_get_track_nameA
Read-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

    B3.4/5.0

    Scored across 212 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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).

    Completeness4/5

    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

    Related MCP Servers