DaVinci Resolve MCP Server
Provides tools for controlling a running DaVinci Resolve instance through its official scripting API, including checking status, listing projects and media pool clips, switching workspace pages, creating and saving projects, importing media, creating empty timelines, and appending media pool clips to timelines.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
DaVinci Resolve MCP Server
A local MCP (Model Context Protocol) server that provides a small, explicit tool surface for controlling DaVinci Resolve through its official scripting API.
It connects to the already-running Resolve instance over stdio — no network listener, no external dependencies beyond the Python mcp package and Resolve's bundled scripting module.
Features
Read-only tools
resolve_status— Resolve version, active page, current project, current timelinelist_projects— List projects in the current project library folderlist_media_pool— List clip names from the project's root Media Pool folder
State-changing tools (use only on explicit request)
set_page— Switch workspace page (media,cut,edit,fusion,color,fairlight,deliver)create_project— Create and activate a new projectsave_current_project— Save the active project to diskimport_media— Import existing media files into the Media Poolcreate_empty_timeline— Create a blank timelineappend_media_pool_clips— Append clips from the Media Pool to the current timeline
What is NOT included
No tools for deleting projects/clips, rendering, exporting, arbitrary shell execution, or network access. The surface is intentionally minimal.
Related MCP server: DaVinci-Resolve-MCP
Requirements
DaVinci Resolve Studio (free or paid), open and fully started
External scripting set to Local (Preferences → System → General)
Automatic scripted actions at Allow safe (or higher)
Python 3.11+ (tested with 3.14)
Installation
1. Clone the repository
git clone https://github.com/YOUR_USERNAME/davinci-resolve-mcp.git
cd davinci-resolve-mcp2. Set up a virtual environment
python3 -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -e .3. Configure environment variables
The server needs to find Resolve's scripting modules. Set these before starting:
export RESOLVE_SCRIPT_API="/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting"
export RESOLVE_SCRIPT_LIB="/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Libraries/Fusion/fusionscript.so"
export PYTHONPATH="$RESOLVE_SCRIPT_API/Modules:.:$PYTHONPATH"4. Run
python -m resolve_mcp.serverThe server communicates over stdio using the MCP protocol.
Integration with MCP Clients
Using with a standalone MCP host
Configure your MCP host (e.g. Claude Desktop, Cursor, or a custom host) to launch the server:
{
"mcpServers": {
"davinci-resolve": {
"command": "python",
"args": ["-m", "resolve_mcp.server"],
"env": {
"RESOLVE_SCRIPT_API": "/Library/Application Support/Blackmagic Design/DaVinci Resolve/Developer/Scripting",
"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:."
}
}
}
}Using with DaVinci Resolve Native MCP
DaVinci Resolve 21+ ships with its own native MCP server at:
/Applications/DaVinci Resolve/DaVinci Resolve.app/Contents/Applications/ResolveMCPThis project's Python MCP server is a complementary layer that adds higher-level tools (project creation, media import, timeline manipulation) on top of Resolve's scripting API.
API Documentation
Complete API stubs and documentation are included in this repository:
api-stubs/— Python type stubs (.pyi) for the scripting APIDaVinciResolveScript.pyi— Main API: projects, timelines, media pool, render jobsfusion_api.pyi— Fusion compositing APIui_api.pyi— Fusion UI Manager API
docs/— Official Blackmagic Design documentationREADME.md— Scripting API guideDCTLReadme.txt— DCTL (DaVinci Color Transform Language) reference
Running Tests
# Unit tests (no Resolve instance required)
python -m unittest discover -s tests -v
# Smoke test (requires Resolve running + environment variables set)
python tests/smoke_test_mcp.pyArchitecture
┌──────────────┐ stdio (MCP) ┌──────────────────┐
│ MCP Host │ ◄──────────────────► │ MCP Server │
│ (Claude, │ │ (Python) │
│ Cursor, │ │ │
│ custom) │ │ resolve_mcp/ │
└──────┬───────┘ │ server.py │
│ │ core.py │
│ Python COM └────────┬─────────┘
▼ ▼
┌─────────────────────────────────────────────────────────┐
│ DaVinci Resolve (running) │
│ │
│ DaVinciResolveScript module ─► Scripting API │
│ (COM/ActiveX via pythoncom) │
└─────────────────────────────────────────────────────────┘The server uses Resolve's Python scripting module which is built on COM/ActiveX. No TCP sockets or network protocols are involved.
License
This MCP server implementation is MIT licensed. The Blackmagic Design API stubs and documentation included in api-stubs/ and docs/ are subject to Blackmagic Design's own licensing terms.
Contributing
Contributions are welcome. Please:
Keep the tool surface minimal and explicit
Add tests for any new logic in
core.pyUpdate the README if you add new tools
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Open-source AI video editor: cut, caption, clip and animate real Revline projects from your agent.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
AI video editor your agent can drive: plan scenes, edit a multi-track timeline, and render MP4s.
AI video editor for agents and humans: timeline, captions, color, audio and generation as MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceExposes 20 tools for project, media, render, and timeline control in DaVinci Resolve 18+ via stdio MCP, enabling AI agents to operate the software through natural language.54MIT
- AlicenseCqualityDmaintenanceA stdio MCP server for DaVinci Resolve on macOS, enabling project control, timeline navigation, frame capture, grade application, and validation through the official Resolve scripting API.64MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to control DaVinci Resolve Studio through the official Scripting API, covering editing, media pool, render, grading, Fusion, Fairlight, and project lifecycle tasks.11,225 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables local AI assistants to control video editing workflows, including projects, media pools, timelines, Fusion graphics, Fairlight audio, color grading, and render queues, through natural language over a local stdio connection.1MIT