PlugWiki
davinci-resolve-mcp logo

davinci-resolve-mcp: community DaVinci Resolve MCP server for Studio

CommunityLocal
Getnpmdavinci-resolve-mcpsamuelgursky/davinci-resolve-mcp

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.

Install davinci-resolve MCP

Claude Code

  1. 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. 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_manager

  • Builds 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 · timeline

  • Organizes 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_pool

  • Browses 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_storage

  • Lists 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 · folder

  • Reads 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_item

  • Changes 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_item

  • Adds, 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_markers

  • Adds 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_markers

  • Adds 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_markers

  • Captures 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_frame

  • Sets 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 · render

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

Technical details
Turning on read-onlyThere 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 toChecks GitHub for new releases about once a day; turn off with DAVINCI_RESOLVE_MCP_UPDATE_CHECK=0
Sign-in and keysNo 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.

ServerOfficialRunsFree ResolveToolsGitHub stars
For DaVinci Resolve
davinci-resolve-mcpThis pageCommunityLocalUp to 21.0373.9K
davinci-resolve-ai-bridge-mcpCommunityLocalSays yes–40
davinci-mcp-professionalCommunityLocalStudio only–25
DaVinci Resolve Lua MCPCommunityLocalSays yes–7
Other tools for the same job
Resolve built-in MCPOfficialBuilt inStudio 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

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 19
  1. Installation and Configuration · github.com
  2. package.json (engines: node >=20.9) · github.com
  3. davinci-resolve-mcp README · github.com
  4. About DaVinci Resolve 21 · blackmagicdesign.com
  5. Resolve 21.1 Adds MCP and Finally Gets Presets · digitalproduction.com
  6. src/server.py (destructive defaults) · github.com
  7. Security Policy · github.com
  8. davinci-resolve-mcp on PyPI · pypi.org
  9. Free edition (in-app bridge) · github.com
  10. Installer writes claude_desktop_config.json to wrong path on Windows MSIX builds · github.com
  11. Server disconnects immediately after initialize on Windows · github.com
  12. resource hungry - why not us the GPU? · github.com
  13. drx generate writes no pTrackVer · github.com
  14. Python scripts never list in Workspace > Scripts on Resolve 21.1 free · github.com
  15. DaVinci Resolve 21.1 Studio and iPad Features · documents.blackmagicdesign.com
  16. davinci-resolve-ai-bridge-mcp · github.com
  17. DaVinci Resolve Lua MCP · github.com
  18. davinci-mcp-professional · github.com
  19. Releases · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.