DaVinci Resolve MCP Server

Model Context Protocol (MCP) server that lets MCP clients control and inspect DaVinci Resolve (including Fusion) through tools and resources.

What it provides

• Project management (create, load, save)
• Timeline operations (create timeline, switch timeline, build from clips)
• Media pool operations (import media, create folders, inspect folders)
• Fusion helpers (add comp to clip, create nodes, create node chains)
• Resolve page navigation
• Advanced scripting (execute_python, execute_lua)

Requirements

• Python 3.10+
• DaVinci Resolve with scripting API available
• An MCP-compatible client (for example Claude Desktop)

Install

git clone https://github.com/apvlv/davinci-resolve-mcp.git
cd davinci-resolve-mcp
uv sync --all-extras --dev

Run the server

uv run davinci-resolve-mcp

The server will try to connect to Resolve on startup. Make sure DaVinci Resolve is running.

MCP client setup

Configure your MCP client to launch the server command:

{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uv",
      "args": ["run", "davinci-resolve-mcp"]
    }
  }
}

Resources

• system://status
• project://current
• project://timelines
• timeline://current
• mediapool://folders
• mediapool://current
• storage://volumes

Tools

Project

• create_project(name)
• load_project(name)
• save_project()

Timeline

• create_timeline(name)
• set_current_timeline(index)

Media

• import_media(file_paths)
• create_folder(name)
• create_timeline_from_clips(name, clip_indices)

Fusion

• add_fusion_comp_to_clip(timeline_index, track_type, track_index, item_index)
• create_fusion_node(node_type, parameters)
• create_fusion_node_chain(node_chain)

Resolve UI

• open_page(page_name) where page name is one of:
• media, edit, fusion, color, fairlight, deliver

Advanced

• execute_python(code)
• execute_lua(script)

Development

make install      # install deps and pre-commit hooks
make lint-check   # ruff check
make format-check # ruff format check
make test         # pytest with coverage
make check        # lint + format + tests

Example usage ideas

• "Create a project named My Documentary"
• "List timelines in the current project"
• "Import these files into the media pool"
• "Open the Color page"
• "Create a Fusion node chain Blur -> ColorCorrector"

License

MIT (see LICENSE)