DaVinci Resolve AI Bridge

Resolve AI Bridge is an open-source local MCP bridge that lets AI coding assistants (Antigravity, Claude, Cursor, Windsurf, Codex, VS Code) inspect and edit projects open in DaVinci Resolve (Free and Studio).

Prerequisite: Requires Python 3.10 or newer (download from python.org/downloads if not already on your computer).

---

Quick Setup

1. One-Line Install (No Download or Folder Navigation Needed)

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/flamexnreal/davinci-resolve-ai-bridge/main/install.sh | bash

Windows PowerShell:

irm https://raw.githubusercontent.com/flamexnreal/davinci-resolve-ai-bridge/main/install.ps1 | iex

(Alternatively, if you downloaded the ZIP, double-click install-macos.command / install-windows.bat or run python3 install.py).

The installer sets up the local runtime environment, installs dependencies, and automatically configures detected AI tools (Claude Desktop, Cursor, Windsurf, VS Code, Claude Code, Codex, and Antigravity).

2. Open DaVinci Resolve

Open DaVinci Resolve and your project.

• Direct attach (default): The bridge connects automatically through Resolve's native scripting interface.
• Fallback launcher: If your build requires the internal console, choose Workspace > Scripts > Resolve AI Bridge > Start AI Bridge in Resolve.

3. Add to your AI client (if not auto-configured)

If you are adding the MCP server manually to an AI client (such as Antigravity or Cursor), use this portable configuration:

{
  "mcpServers": {
    "resolve-ai-bridge": {
      "command": "sh",
      "args": [
        "-c",
        "exec \"$HOME/.resolve-ai-bridge/.venv/bin/python\" \"$HOME/.resolve-ai-bridge/bridge/server.py\""
      ]
    }
  }
}

Or using the installed global binary:

{
  "mcpServers": {
    "resolve-ai-bridge": {
      "command": "resolve-ai-bridge"
    }
  }
}

4. Verify

With Resolve open, run:

python3 tools/doctor.py

Then ask your AI:

"Call resolve_status and tell me what project is currently open."

---

Available Tools

• resolve_status: Check bridge connection, Resolve version, active project, and timeline.
• timeline_overview: Inspect tracks, clips, stable item IDs (V1.1, V2.1), timecode, and markers.
• project_info: Get project frame rate, resolution, and timeline counts.
• list_timelines / open_timeline / create_timeline: Manage timelines.
• list_media / import_media / append_media: Search and import media pool items.
• add_image: Place still images/overlays with custom duration and track index.
• set_clip_transform: Adjust pan, tilt, zoom, rotation, opacity, and retiming properties.
• split_clip: Razor cut clips at specific frame numbers, timecodes, or playhead.
• animate_zoom: Apply keyframed zoom in/out Fusion compositions across clip ranges.
• insert_title: Add text titles to the timeline.
• add_marker / delete_marker: Place and remove timeline markers.
• set_clip_property / set_clip_color / set_clip_enabled: Clip inspection and toggles.
• render_current_timeline: Start timeline export with named presets.

---

Motion Graphics with Remotion

For programmatic motion graphics, lower thirds, animated titles, and video overlays, using Remotion (React-based video) alongside this bridge is recommended. AI coding agents can generate React components with precise timing, animations, typography, and layout, render them to video files, and place them directly onto your DaVinci Resolve timeline using append_media or add_image.

Getting Started with Remotion

1. Install Node.js LTS from nodejs.org.
2. Install the official Remotion skill for AI agents:

   npx -y skills@latest add remotion-dev/skills -g -y
   

3. Create a motion graphics project:

   npx create-video@latest --yes --blank motion-graphics
   cd motion-graphics
   npm install
   npm run dev
   

4. Ask your AI coding agent to generate titles, transitions, or overlays in Remotion, render the composition, and import it into your open DaVinci Resolve project.

See docs/REMOTION.md for full workflows and rendering instructions.

---

Free vs Studio Version

Blackmagic Design's scripting APIs provide a common superset for both the Free and Studio versions of DaVinci Resolve. No feature in this bridge requires Studio-only tools. If external scripting is disabled in Resolve Preferences, the bridge falls back to the internal Console worker and all tools behave identically.

---

Troubleshooting

Run the diagnostic tool before editing files:

python3 tools/doctor.py

• Bridge reported offline: Ensure DaVinci Resolve is open with a project. Check Preferences > System > General > External scripting using is set to Local. If needed, click Workspace > Scripts > Resolve AI Bridge > Start AI Bridge.
• Missing Scripts Menu: Fully quit and reopen DaVinci Resolve so it rescans the script directories.
• Detailed troubleshooting guides are available in docs/TROUBLESHOOTING.md.

---

License

MIT. See LICENSE.