
davinci-resolve-mcp: community DaVinci Resolve MCP server for Studio
Lets your AI assistant edit, organize, grade and render in DaVinci Resolve Studio by talking to it in plain words.
This community server lets Claude, Cursor and other AI apps open projects, build timelines, add markers, set up renders and grade in DaVinci Resolve for you. It needs DaVinci Resolve Studio, the paid version, because Blackmagic only lets outside programs control Studio. A workaround ran it on the free version up to Resolve 21.0, but Resolve 21.1 moved Python scripting to Studio and the workaround no longer loads. Resolve Studio 21.1 also ships Blackmagic's own built-in MCP server, the official way to connect Claude, Claude Code or Codex.
Good for
- Editors who want the assistant to build assembly cuts, organize bins and tidy metadata
- Assistant editors prepping sync, conform and review markers on long projects
- Colorists who want grades copied, checked and exported as LUTs on request
- Post teams that batch render many deliverables from one timeline
- Resolve Studio owners who want confirmation steps and a safe mode before risky changes
Works in
10 supported · 2 should work
Tap an app to see how to set it up and any known problems.
The setup command adds it to your project's .mcp.json file. GitHub
The setup command writes Claude Desktop's config for you, including the packaged Windows app's own config folder.
The setup command adds it to ~/.cursor/mcp.json. GitHub
The setup command adds it to the workspace .vscode/mcp.json for Copilot. GitHub
The setup command adds it to Windsurf's MCP config file. GitHub
The setup command writes it into ~/.codex/config.toml. Paths there must be full paths. GitHub
The setup command writes Cline's settings inside VS Code. GitHub
Add it by hand under Settings, Tools, AI Assistant, MCP. GitHub
The setup command adds it to OpenCode's opencode.json. GitHub
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install davinci-resolve MCP
Claude Code
- 1
Copy this prompt.
Add the davinci-resolve MCP server to Claude Code. Run this command: npx davinci-resolve-mcp setup --clients claude-code Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js 20.9+, Python 3.10+, DaVinci Resolve Studio, open.
Before you start, open DaVinci Resolve Studio and set Preferences, General, External scripting using to Local. The free version cannot be controlled this way on Resolve 21.1. The setup command installs the server, builds its Python environment, finds Resolve and writes this app's config for you. Restart the app afterwards.
The npx entry starts the server from the copy that the setup command installs, so run the setup command once first. If it will not connect, run npx davinci-resolve-mcp doctor, or python3 scripts/doctor.py from the install folder; most failures are the wrong Python version.
From the project README. Source.
Tools
Opens, lists, creates, saves and deletes your Resolve projects
Lists the projects in your Project Manager, opens, creates, saves, imports, exports or deletes them, and gives a one-shot summary of the open project.
Try: “List my projects and open the one called 'My Film'”
Delete ·
project_managerBuilds and edits timelines: tracks, clips, titles, imports and exports
Works on the current timeline: adds or removes tracks and clips, creates timelines, adds titles and generators, and imports or exports edit lists. Risky changes archive the timeline first.
Try: “Create a timeline called 'Assembly Cut' from all clips in the current bin”
Delete ·
timelineOrganizes the Media Pool: bins, clips, timelines and imports
Creates bins, moves and deletes clips, builds timelines and multicam clips from clips, and imports media into the Media Pool, with safer checked versions of each action.
Try: “Make a bin for each shooting day and move the clips into them”
Delete ·
media_poolBrowses your drives and imports files into the Media Pool
Lists the drives and folders Resolve can see and imports files or whole folders into the Media Pool.
Try: “Import everything in the /Volumes/Card01 folder into the Media Pool”
Write ·
media_storageLists a bin's clips and runs transcription or slate analysis on it
Lists the clips and sub-bins in a Media Pool folder, exports it, and runs Resolve's transcription, audio classification and slate detection on everything in it.
Try: “Transcribe every clip in the Interviews bin”
Write ·
folderReads and edits a clip's metadata, properties and proxies
Reads or changes one clip's metadata, properties, marks and clip color, and links or unlinks proxy media for it.
Try: “Set the scene and take metadata on this clip to 12 and 3”
Write ·
media_pool_itemChanges a clip on the timeline: size, position, speed, keyframes
Reads and sets a timeline clip's transform, crop, opacity, speed, audio volume and keyframes, plus multicam and other clip properties.
Try: “Slow the second clip on video track 1 to 50% with optical flow”
Write ·
timeline_itemAdds, finds and removes markers on the timeline and moves the playhead
Adds, lists and deletes timeline markers and moves the playhead to a timecode.
Try: “Add a red marker named 'Fix audio' at 01:02:10:00”
Delete ·
timeline_markersAdds markers, flags and clip colors to clips on the timeline
Adds, reads and removes markers, flags and clip colors on individual clips in the timeline.
Try: “Flag every clip on track 2 that has no audio in green”
Delete ·
timeline_item_markersAdds markers and flags to clips in the Media Pool
Adds, reads and removes markers and flags on Media Pool clips, including markers that carry custom notes.
Try: “Mark the clap in each of these clips with a blue marker”
Delete ·
media_pool_item_markersCaptures a frame from the timeline so the assistant can see it
Grabs a still of what Resolve shows at a timecode so the assistant can check framing, titles, a grade or a cut by looking at it.
Try: “Show me the frame at 00:00:42:00 so we can check the title placement”
Files ·
timeline_frameSets up render jobs, checks formats and starts or stops renders
Adds and removes render jobs, checks which formats and codecs work, applies render settings, starts or stops rendering and checks the output.
Try: “Build a ProRes 422 HQ render job for this timeline and start it”
Delete ·
renderGrades clips: copies grades, versions, LUTs and color matching
Works on a clip's color grade: snapshots and versions, copies a grade to other clips, applies LUTs and DRX grades, and matches clips to a hero shot after you confirm.
Try: “Copy this clip's grade to every clip from camera B”
Delete ·
timeline_item_colorReads and edits color nodes on a clip, timeline or color group
Reads node counts, LUTs and cache settings on a grade's node graph and sets LUTs, enables or disables nodes, or applies a saved grade.
Try: “Put the Rec709 LUT on node 2 of this clip”
Write ·
graphLists color groups and the clips in each
Lists color groups, renames them, and shows which clips belong to each and how many nodes their group grades have.
Try: “Which clips are in the 'Exterior Day' color group?”
Write ·
color_groupManages Gallery albums for stills and PowerGrades
Lists, names, picks and creates Gallery still albums and PowerGrade albums.
Try: “Create a new still album called 'Client looks'”
Write ·
galleryGrabs, imports, exports and labels Gallery stills
Grabs stills from the viewer, imports and exports still files, labels them and removes them from an album.
Try: “Grab a still of every clip and export them to my Desktop as JPGs”
Delete ·
gallery_stillsAnalyzes footage: transcripts, silence, slates, sync and shot notes
Analyzes clips, bins or a whole project without touching the source files: transcription, silence and slate detection, visual notes, and then writes summaries and markers back into Resolve.
Try: “Analyze the Interviews bin and add markers wherever someone says the product name”
Runs code ·
media_analysisRuns Resolve's AI tools on the timeline, like auto subtitles
Creates subtitles from the audio, lists and applies subtitle and title presets, and runs other Resolve AI analysis on the current timeline.
Try: “Create English subtitles for this timeline from the dialogue”
Write ·
timeline_aiPlans and runs assembly, tighten and swap edits from analysis
Proposes an assembly cut, tighter cuts or shot swaps from the media analysis, explains each choice, and only applies the plan after you confirm.
Try: “Plan a tighter version of this interview cut and show me what you would remove”
Write ·
edit_engineShows timeline backups and rolls back changes
Lists the timeline copies saved before each risky change and restores one if you want to undo.
Try: “Undo your last change and restore the timeline from before it”
Write ·
timeline_versioningAdds, imports and exports Fusion compositions on a clip
Adds, lists, loads, imports, exports and deletes Fusion compositions attached to a timeline clip.
Try: “Add a Fusion comp to the first clip on track 1”
Delete ·
timeline_item_fusionBuilds Fusion node graphs: adds tools, sets inputs, connects nodes
Inspects a Fusion composition, adds tools such as Text+, sets their inputs and connects nodes, with checks that the connections are valid.
Try: “Add a Text+ title that says 'Chapter 1' to this clip's Fusion comp”
Delete ·
fusion_compManages alternate takes on a timeline clip
Adds takes to a clip, lists them, switches the selected take, deletes takes or finalizes one.
Try: “Add take 4 of this shot as an alternate take and select it”
Delete ·
timeline_item_takesReads and changes project settings like frame rate and color
Reads every project setting or one by name, changes settings, renames the project and loads settings presets. Some settings Resolve does not let it change.
Try: “What is this project's timeline frame rate and color science?”
Write ·
project_settingsMoves between and manages folders in the Project Manager
Lists, opens, creates and deletes folders in the Project Manager and moves up to the parent or root folder.
Try: “Create a folder called '2026 Clients' in the Project Manager”
Delete ·
project_manager_foldersShows and switches project databases
Shows the current project database, lists available ones and switches to another.
Try: “Which project database am I on right now?”
Write ·
project_manager_databaseCreates, loads and restores Blackmagic Cloud projects
Creates, loads, imports and restores cloud projects. Needs Blackmagic Cloud set up.
Try: “Load the cloud project called 'Series Ep 3'”
Write ·
project_manager_cloudImports and exports render and burn-in presets
Imports, exports, lists and deletes render presets and burn-in presets as files.
Try: “Export my YouTube 4K render preset to a file I can share”
Delete ·
render_presetsSaves, loads and shares Resolve window layouts
Lists, saves, loads, updates, imports, exports and deletes UI layout presets.
Try: “Save the current window layout as 'Grading'”
Delete ·
layout_presetsFinds, installs and removes LUT files
Lists every LUT Resolve can see and installs or removes LUT files in Resolve's LUT folder.
Try: “Which LUTs do I have for Sony S-Log3?”
Delete ·
lutWrites and installs DCTL color shaders and ACES transforms
Creates, installs and removes DCTL files and ACES transforms so they show up in Resolve's LUT and effects lists.
Try: “Install this DCTL and make Resolve pick it up”
Delete ·
dctlWrites and installs Fusion Fuse plugins
Creates, installs, edits and removes Fusion Fuse plugins. A new Fuse needs a Resolve restart before it appears.
Try: “Write a simple Fuse that adds film grain and install it”
Delete ·
fuse_pluginWrites and installs scripts for Resolve's Scripts menu
Creates, installs and removes Lua or Python scripts that appear under Workspace, Scripts in Resolve.
Try: “Install a script on the Edit page that exports all markers to a CSV”
Delete ·
script_pluginUsed by the assistant behind the scenes
Launches Resolve, switches pages and checks the connection
Starts or reconnects to Resolve, switches pages, reports the version and whether it is Studio, and checks background jobs. The assistant calls it when it cannot reach Resolve.
Write ·
resolve_controlReads built-in editing, color and audio guidance before acting
Gives the assistant the project's own editing, color, audio and workflow guidance so it checks known traps before a creative or risky change.
Read ·
knowledgeChanges the server's own defaults, like safe mode and update checks
Reads and changes the server's settings: analysis defaults, update checks and safety options such as safe mode and confirmation tokens.
Try: “Turn on safe mode for risky deletes”
Write ·
setup
Read from the source code
Pros and cons
Good
- Covers editing, media pool, color, Fusion, Fairlight, render and project settings.
- One setup command installs it and writes the config for Claude, Cursor, VS Code, Codex and other AI apps.
- Default mode groups actions into 37 tools to keep the assistant's context small.
- Deletes ask for confirmation, and timelines are saved before the compound server changes them.
- Leaves camera original files alone during analysis.
- Very active, with fixes shipped within days and detailed answers on issues.
- Free and MIT-licensed.
Watch out
- Needs paid Resolve Studio for the normal setup.
- The free-version workaround does not load on Resolve 21.1.
- No read-only mode, and safe mode is off by default.
- Python version problems are the most common reason it will not connect.
- Media analysis can keep every CPU core busy and needs extra installs like ffmpeg and Whisper.
- Releases land several times a week, so behavior changes often.
Permissions
medium risk · 5 things to watch · 4 advisories
Medium risk
The assistant can delete projects, clips and markers and install scripts into Resolve, not just read your timeline. Turn on safe mode and keep backups of your project database before you let it make changes.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete projects, clips and markers
Deletes ask for confirmation by default. Turn on safe mode to block the riskiest ones, and back up your project database first. github.com
It can install scripts, DCTLs and Fuses
Anything it installs runs with your own access to disk and network. Only approve installs you asked for. github.com
The free-version workaround can stop working
The author says Blackmagic could close it at any update, and on Resolve 21.1 free it no longer loads. github.com
A different project uses the same PyPI name
pip install davinci-resolve-mcp installs someone else's server. Use the npx setup command or the GitHub repo. pypi.org
Camera original files stay untouched
Analysis writes reports to separate folders and metadata to the Resolve project. It changes source media only if you ask for exactly that. github.com
Security advisories
4 known advisories, all fixed in a newer version.
- Argument injection → command execution in conform/relink_scalefix via unvalidated footageDir/footageDirs passed to findhigh · Fixed in 4.14.3 · GHSA-x29h-6rgf-w233
- Project deletion and HIGH-rated deletes bypassed safe mode; the open project could be deleted without confirmationmedium · Fixed in 3.0.1 · GHSA-gmp7-qjp9-m7gm
- Plugin install/remove and script execution bypassed safe mode, dry-run refusal and the audit logmedium · Fixed in 3.0.0 · GHSA-vh75-g46q-hgcw
- Networked transport wrote its generated bearer token to logs/server.loglow · Fixed in 2.212.1 · GHSA-8f4v-j8rq-hj47
Technical details
| Turning on read-only | There is no read-only mode. Deletes and other risky actions ask for a confirm token by default. destructive.safe_mode (off by default, set with setup set_defaults) blocks high-risk deletes unless allow_risky_operation is passed. Changes are written to a security audit log. |
|---|---|
| Talks to | Checks GitHub for new releases about once a day; turn off with DAVINCI_RESOLVE_MCP_UPDATE_CHECK=0 |
| Sign-in and keys | No account or key. It runs on your computer and talks to the Resolve app you have open. |
Alternatives
Pick this server if you own Resolve Studio and want 37 grouped tools with confirmation on risky actions. Blackmagic's built-in MCP server in Studio 21.1 is the official option and needs no install.
| Server | Official | Runs | Free Resolve | Tools | GitHub stars |
|---|---|---|---|---|---|
| For DaVinci Resolve | |||||
| davinci-resolve-mcpThis page | Community | Local | Up to 21.0 | 37 | 3.9K |
| davinci-resolve-ai-bridge-mcp | Community | Local | Says yes | – | 40 |
| davinci-mcp-professional | Community | Local | Studio only | – | 25 |
| DaVinci Resolve Lua MCP | Community | Local | Says yes | – | 7 |
| Other tools for the same job | |||||
| Resolve built-in MCP | Official | Built in | Studio only | – | – |
What people say
People like how fast the maintainer fixes what they report and dislike how heavy media analysis can be on the computer.
What people like
- Bug reports get detailed answers and a fix release within days.
- A user confirmed a grading fix on Resolve Studio 21.1 the day after reporting the bug.
Common complaints
- Media analysis kept every CPU core busy for one user; a later release cut that work by about two thirds.
- Some grade actions reported success while changing nothing, until a fix added a clear refusal.
- Free-version users lost the workaround when Resolve 21.1 moved Python scripting to Studio.
In their words
“this MCP is resource hungry. would be nice to offload this to GPU instead”ykcabGitHub issueOct 2026
“Every call returned `success: true`, but the timeline grade never changed. On the second try it also deleted a node I had added to the timeline graph by hand.”Svnow132GitHub issueOct 2026
“Confirmed on 4.15.5 with Studio 21.1.2.10. A timeline apply of a `drx generate` (direct) file now returns `DRX_NO_TIMELINE_GRADE`, and the same file still applies to a clip. Thanks.”Svnow132
Questions
Does it work with the free version of DaVinci Resolve?
Not on current versions. It is built for Resolve Studio, because Blackmagic only lets outside programs control Studio. Up to Resolve 21.0 a small script inside the free version worked as a bridge, but Resolve 21.1 moved Python scripting to Studio and the bridge no longer loads.
Does DaVinci Resolve have an official MCP server?
Yes, since Resolve Studio 21.1. Blackmagic built an MCP server into Studio; go to File, Setup AI Assistants to connect Claude, Claude Code or Codex. It does not work in the free version. This server is a separate community project that also runs on Studio versions from 18.5.
Is it free?
Yes, the server is free and open source under the MIT license. You need a paid Resolve Studio license for the normal setup, because the free Resolve 21.1 cannot be controlled by it.
Why won't it connect to Resolve?
Check three things. Resolve must be open, Preferences, General, External scripting using must be set to Local, and the server needs a 64-bit Python 3.10 or newer, with 3.10 to 3.12 the safest. The included doctor script, python3 scripts/doctor.py, prints the exact fix.
Can it delete my projects or footage?
It can delete projects, clips, timelines and markers, and it asks for confirmation first by default. It does not change your camera original files unless you ask for exactly that.
How do I stop it making risky changes?
Ask the assistant to turn on safe mode through the server's setup tool. Safe mode blocks the riskiest deletes unless you allow each one. There is no full read-only mode.
Should I use compound or full mode?
Use compound mode, the default. It groups actions into 37 tools so the assistant uses less context. Full mode has 390 tools, one per Resolve function, for people who want that level of detail.
Is pip install davinci-resolve-mcp the same server?
No. That PyPI package is a different project by another author. Install this one with the npx command in the install box or from the GitHub repo.
Can it control Resolve on another computer?
Yes, if you switch Resolve's scripting setting to Network and point the server at that machine's address. The author recommends Local mode and a firewall otherwise, because network scripting lets others control Resolve.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
davinci-resolve-mcp- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 4.17.0
- License
- MIT
- Last commit
- Oct 29, 2026
- Open issues
- 4
Project pageGitHubnpmInstallation and ConfigurationChangelogIssues
Other DaVinci Resolve MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 19Hide
- Installation and Configuration · github.com
- package.json (engines: node >=20.9) · github.com
- davinci-resolve-mcp README · github.com
- About DaVinci Resolve 21 · blackmagicdesign.com
- Resolve 21.1 Adds MCP and Finally Gets Presets · digitalproduction.com
- src/server.py (destructive defaults) · github.com
- Security Policy · github.com
- davinci-resolve-mcp on PyPI · pypi.org
- Free edition (in-app bridge) · github.com
- Installer writes claude_desktop_config.json to wrong path on Windows MSIX builds · github.com
- Server disconnects immediately after initialize on Windows · github.com
- resource hungry - why not us the GPU? · github.com
- drx generate writes no pTrackVer · github.com
- Python scripts never list in Workspace > Scripts on Resolve 21.1 free · github.com
- DaVinci Resolve 21.1 Studio and iPad Features · documents.blackmagicdesign.com
- davinci-resolve-ai-bridge-mcp · github.com
- DaVinci Resolve Lua MCP · github.com
- davinci-mcp-professional · github.com
- Releases · github.com