resolve-free-mcp
Enables editing video in the free edition of DaVinci Resolve via a Lua file-mailbox bridge, with tools for checking bridge/project status, listing timelines, importing media, building timelines and appending source ranges, zooming clips, adding Fusion text cards, rendering timelines with job status, and running arbitrary Lua inside Resolve.
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.
resolve-free-mcp
Let Claude edit video in the free edition of DaVinci Resolve.
Resolve's scripting API is only reachable from outside the app in the paid Studio edition. The free edition still runs Lua, but only from its own console. This project gets around that with a file mailbox: a small Lua loop running inside Resolve picks up commands from a folder, and an MCP server on the outside writes them.
Claude ── MCP ──> server.py ── inbox/cmd_N.lua ──> bridge.lua (inside Resolve's console)
^ │
└──── outbox/res_N_k.xml <──────────┘The return channel
Getting commands in is easy. Getting results out is the interesting part. Rather than depend on file I/O from the console, the bridge uses something the API is guaranteed to offer: exporting a timeline. So each command:
runs its Lua body inside
pcall,cuts the result string into 110-character chunks,
renames a scratch timeline
__out__<k>~<chunk>and exports it as FCP7 XML,exports a final
__out__donemarker.
The server waits for the marker, then reads the chunks back out of the
<name> element of each XML file. Characters a timeline name cannot hold are
replaced with _, so results are best kept to simple key=value;key=value
strings.
Related MCP server: resolve-mcp
Tools
Tool | What it does |
| Resolve version, current project and timeline |
| Timelines in the current project |
| Import files into the media pool, skipping ones already there |
| Create a timeline (default 1080×1920, 30 fps) and append source ranges in order |
| Zoom a clip, for example to fill a vertical frame |
| Add a one- or two-line text card over a clip through a Fusion comp |
| Render a timeline and report job status |
| Run any Lua body inside Resolve, with |
| Tell the bridge loop to exit |
run_lua is the escape hatch: anything the Resolve API can do from the console
can be done through it.
Setup
Requires DaVinci Resolve (developed against 21.1, free edition, macOS) and uv.
Install the bridge. This creates
~/resolve_bridgeand prints the line to paste into Resolve:python3 install_bridge.pyIn Resolve, once per session: Workspace > Console > Lua, paste the printed
fu:RunScript("…/bridge.lua")line. The console is busy while the bridge runs;stop_bridgeends it.Add the server to Claude Desktop (Settings > Developer > Edit Config):
{ "mcpServers": { "resolve": { "command": "/path/to/uv", "args": ["run", "--directory", "/path/to/resolve-free-mcp", "server.py"] } } }If the bridge lives somewhere other than
~/resolve_bridge, setRESOLVE_BRIDGE_DIRin the server'senv.add_text_carddefaults to Cormorant SC and Cormorant Garamond (both free on Google Fonts). A font that is not installed makes the render fail, so install them or pass your ownfont1/font2.
Limits
One command at a time; commands are numbered and processed in order.
Results pass through timeline names, so they are short and lose punctuation.
Paths are passed to Resolve as-is: use absolute paths.
Built for one person's reel-editing workflow on macOS. Not tested on Windows or Linux, or on Resolve Studio (which does not need this workaround).
License
MIT. Not affiliated with Blackmagic Design.
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
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
MCP server for Kling AI video generation
MCP server for Hailuo (MiniMax) AI video generation
MCP server for Google Veo AI video generation
Related MCP Servers
- FlicenseCqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude to interact with DaVinci Resolve Studio, providing advanced control over editing, color grading, audio, and other video production tasks.3222-
- AlicenseNot gradedqualityCmaintenanceComprehensive MCP server for DaVinci Resolve with 295+ tools to control projects, timelines, editing, color grading, rendering, and more via natural language.106 PyPI7MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for DaVinci Resolve video editing, enabling AI agents to execute editing operations, manage creative libraries, and analyze media content.-
- FlicenseAqualityBmaintenanceAn MCP server that gives Claude Code hands inside DaVinci Resolve Studio, enabling project management, status checks, snapshots, and arbitrary Python scripting via the Resolve API.51-