resolve-mcp

resolve-mcp

The most comprehensive MCP server for DaVinci Resolve. 295+ tools covering the complete DaVinci Resolve scripting API (v20.3) — control every aspect of Resolve from Claude, ChatGPT, or any MCP-compatible AI assistant.

---

What is resolve-mcp?

resolve-mcp is a Model Context Protocol (MCP) server that exposes 295+ tools for controlling DaVinci Resolve through AI assistants like Claude, Claude Code, Cursor, Windsurf, ChatGPT, and any other MCP client.

It turns natural language into Resolve scripting API calls — letting you manage projects, edit timelines, grade color, render deliverables, manage media pools, control Fusion compositions, and more, all through conversation with an AI.

Why resolve-mcp?

• Complete API coverage — 295+ tools spanning every Resolve scripting API surface: projects, media pool, timelines, editing, markers, rendering, color grading, Fusion, Fairlight, galleries, node graphs, Dolby Vision, and stereo 3D
• Zero code required — just talk to your AI assistant: "Create a new timeline called 'Final Cut' at 24fps" or "Add a dissolve transition to every cut point"
• One-line install — uvx resolve-mcp or pip install resolve-mcp
• Works with any MCP client — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code + Continue, or your own MCP client
• Optional AI editing tools — 3 bonus Gemini-powered tools for AI timeline analysis, marker-driven editing, and automated marker placement
• Cross-platform — macOS, Windows, Linux (wherever Resolve runs)

---

Quick Start

Prerequisites

1. DaVinci Resolve (Free or Studio) must be running
2. Enable scripting: Preferences → System → General → External scripting using = Network
3. Python 3.11+
4. ffmpeg (for AI tools only): brew install ffmpeg (macOS) or apt install ffmpeg (Linux)

Install

# Using uvx (recommended — runs in isolated environment)
uvx resolve-mcp

# Using pip
pip install resolve-mcp

# Using pipx
pipx install resolve-mcp

# Install with the AI editing assistant (resolve-assistant) included
pip install resolve-mcp[assistant]

Configure Claude Desktop

Add to your Claude Desktop MCP config:

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

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"]
    }
  }
}

Configure Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"]
    }
  }
}

Configure Cursor / Windsurf / VS Code

Follow your editor's MCP server configuration docs, pointing to uvx resolve-mcp as the command.

Enable AI Bridge Tools (Optional)

To use the 3 Gemini-powered AI tools (resolve_analyze_timeline, resolve_add_markers, resolve_build_from_markers), set your Gemini API key:

{
  "mcpServers": {
    "resolve-mcp": {
      "command": "uvx",
      "args": ["resolve-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key-here"
      }
    }
  }
}

Windows note: If uvx is not on your system PATH, use the full path to uvx.exe (e.g., C:\\Users\\YOU\\.local\\bin\\uvx.exe) as the "command" value.

Get a free Gemini API key at aistudio.google.com.

---

Using Both Servers Together — resolve-mcp + resolve-assistant

resolve-mcp gives you 295+ tools for direct DaVinci Resolve control — projects, timelines, editing, color grading, rendering, Fusion, Fairlight, and more.

resolve-assistant is a separate MCP server that adds AI-powered automatic editing — point it at a folder of footage and give it an editing instruction, and it uses Google Gemini to watch every frame, plan the edit, and build the timeline in Resolve automatically.

They are independent MCP servers. You can use either one alone, or both together for the complete AI video editing toolkit. When used together, you get full manual control over Resolve (resolve-mcp) plus AI-driven footage analysis and automatic timeline building (resolve-assistant).

Install Both With One Command

# Install resolve-mcp with the AI editing assistant included
pip install resolve-mcp[assistant]

# Or install them separately
pip install resolve-mcp
pip install resolve-assistant

Configure Both Servers