ResolveMCP

Connect DaVinci Resolve Studio to Claude AI through the Model Context Protocol (MCP), enabling AI-assisted video editing, color grading, Fusion compositing, and more — all through natural language.

Note: This is a third-party integration and is not created by or affiliated with Blackmagic Design.

Features

Core

• Direct connection to DaVinci Resolve Studio's scripting API — no addon or plugin needed inside Resolve
• Project inspection and navigation across all pages (Media, Cut, Edit, Fusion, Color, Fairlight, Deliver)
• Media pool management (import, organize, browse)
• Timeline creation and editing
• Arbitrary Python code execution with the full Resolve API

Color Grading

• Node graph inspection and manipulation
• LUT application
• CDL (Color Decision List) adjustments

Fusion (Compositing / VFX)

• Create, import, export, and manage Fusion compositions
• Insert Fusion generators, titles, and blank compositions
• Merge timeline items into Fusion clips

AI / DaVinci Neural Engine

• Magic Mask — AI-powered subject isolation
• Smart Reframe — automatic reframing for different aspect ratios
• Stabilization — AI-powered clip stabilization
• Scene Cut Detection — auto-detect and cut at scene boundaries
• Subtitle Generation — AI speech-to-text with multi-language support
• Voice Isolation — separate speech from background noise

Rendering

• Browse available formats and codecs
• Configure render settings
• Queue and start render jobs
• Monitor render progress

Code Execution

• execute_resolve_code — run any Python code with the Resolve API available (resolve, project, mediaPool, timeline, mediaStorage pre-loaded)
• This is the power tool: anything the Resolve Python API can do, Claude can do

Architecture

Unlike BlenderMCP which requires a socket-based addon, ResolveMCP connects directly to DaVinci Resolve via its native scripting API. This means a simpler, single-process architecture:

Claude AI (MCP Client)
    |
    v
ResolveMCP Server (FastMCP)
    |
    v
DaVinciResolveScript (fusionscript.so)
    |
    v
DaVinci Resolve Studio (running)

No addon to install inside Resolve. No socket server. Just one MCP server that talks directly to Resolve.

Prerequisites

• DaVinci Resolve Studio 18.0+ (free version has limited scripting support)
• Python 3.10+
• uv package manager

Install uv:

# macOS
brew install uv

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Installation

Step 1: Configure Claude Desktop

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the mcpServers entry:

{
  "mcpServers": {
    "resolve": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "RESOLVE_SCRIPT_LIB": "/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so",
        "PYTHONPATH": "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules/"
      }
    }
  }
}

{
  "mcpServers": {
    "resolve": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "RESOLVE_SCRIPT_LIB": "C:\\Program Files\\Blackmagic Design\\DaVinci Resolve\\fusionscript.dll",
        "PYTHONPATH": "C:\\ProgramData\\Blackmagic Design\\DaVinci Resolve\\Support\\Developer\\Scripting\\Modules\\"
      }
    }
  }
}

{
  "mcpServers": {
    "resolve": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "RESOLVE_SCRIPT_LIB": "/opt/resolve/libs/Fusion/fusionscript.so",
        "PYTHONPATH": "/opt/resolve/Developer/Scripting/Modules/"
      }
    }
  }
}

Step 2: Enable Scripting in Resolve

1. Open DaVinci Resolve Studio
2. Go to Preferences > General
3. Under External scripting using, select Local (or Network if running remotely)

Step 3: Restart Claude Desktop

Quit and reopen the Claude Desktop app. You should see the ResolveMCP tools available (hammer icon).

Usage

Make sure DaVinci Resolve Studio is running with a project open, then talk to Claude:

Project & Navigation

"What project do I have open?"
"Switch to the Color page"
"How many timelines are in this project?"

Media & Timeline

"Import all the .mp4 files from ~/Videos/project/ into the media pool"
"Create a new timeline called 'Rough Cut'"
"What clips are on video track 1?"
"Add a red marker at frame 200 called 'Fix audio here'"

Color Grading

"Show me the node graph for the first clip"
"Apply this LUT to node 1: /path/to/my.cube"
"Set CDL values: increase slope to 1.2 and reduce saturation to 0.8"

AI Features

"Run scene cut detection on the timeline"
"Apply Smart Reframe to the first clip"
"Create a Magic Mask on clip 3 to isolate the subject"
"Generate subtitles from the audio in English"
"Enable Voice Isolation on audio track 1"
"Stabilize the second clip on video track 1"

Fusion

"List all Fusion compositions on the first clip"
"Add a Fusion composition to clip 2"
"Insert a Fusion title into the timeline"

Rendering

"What render formats are available?"
"Set up a render to ProRes 422 HQ, output to ~/Desktop/exports"
"Add a render job and start rendering"
"What's the render progress?"

Power Tool

"Run this code: print(project.GetSetting('timelineFrameRate'))"

Available Tools (48)

| Category | Tools | |---|---| | Project & Navigation | get_project_info, open_page, get_current_page | | Media Pool | get_media_pool_structure, import_media, create_timeline | | Timeline | get_current_timeline_info, get_timeline_items, append_to_timeline, add_marker, get_markers, set_current_timecode, get_current_timecode | | Item Properties | get_timeline_item_properties, set_timeline_item_property | | Color Grading | get_node_graph, set_lut, set_cdl | | Rendering | get_render_formats, get_render_settings, set_render_settings, add_render_job, start_rendering, get_render_status, stop_rendering | | AI / Neural Engine | create_magic_mask, regenerate_magic_mask, smart_reframe, stabilize, detect_scene_cuts, create_subtitles_from_audio | | Audio | get_voice_isolation_state, set_voice_isolation_state | | Fusion | get_fusion_comp_list, add_fusion_comp, import_fusion_comp, export_fusion_comp, load_fusion_comp, delete_fusion_comp, rename_fusion_comp, create_fusion_clip, insert_fusion_generator, insert_fusion_composition, insert_fusion_title | | Export | export_timeline, export_current_frame | | Thumbnail | get_current_thumbnail | | Code Execution | execute_resolve_code |

Troubleshooting

"Could not connect to DaVinci Resolve"

• Make sure DaVinci Resolve Studio is running
• Check that scripting is enabled in Preferences > General > External scripting using
• Verify the RESOLVE_SCRIPT_LIB path matches your installation

"Failed to import DaVinciResolveScript"

• Check that PYTHONPATH in the config points to the correct Modules directory
• On macOS, the default path is /Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting/Modules/

"No active timeline"

• Open a project and make sure a timeline is loaded before using timeline tools

Tools not appearing in Claude Desktop

• Make sure uv is installed: uv --version
• Restart Claude Desktop after editing claude_desktop_config.json
• Check the Claude Desktop logs for MCP server errors

Important Notes

• DaVinci Resolve Studio is required for full scripting API access. The free version has limited scripting support.
• execute_resolve_code runs arbitrary Python — review code before executing.
• Some tools require being on a specific page (e.g., thumbnails require the Color page).
• The server connects to whichever project is currently open — switching projects in Resolve is reflected immediately.

License

MIT

Acknowledgments

Inspired by BlenderMCP by Siddharth Ahuja.
Built with the Model Context Protocol by Anthropic.