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)

Related MCP server: DaVinci Resolve MCP Server

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)