mcp.film

mcp.film / Editing & Post / FCPXML MCP

FCPXML MCP

Communityby Community (DareDev256 / James Dare)freeverified Oct 12, 2026

Turn Final Cut Pro XML into QC, markers, rough cuts, and cross-NLE handoffs.

What it does

FCPXML MCP gives agents a deep Final Cut Pro XML workbench: inspect timelines, detect flash frames and gaps, add marker batches, build rough cuts, reformat cuts, export EDL/CSV, and write Resolve or FCP7 handoff files. It fits the assistant-editor jobs that do not require eyes on the frame: count, QC, annotate, restructure, and push a clean XML back into the edit bay.

Connect

Claude Code
claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "fcpxml-mcp": {
      "command": "uvx",
      "args": [
        "fcp-mcp-server"
      ]
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "fcpxml-mcp": {
      "command": "uvx",
      "args": [
        "fcp-mcp-server"
      ]
    }
  }
}
Auth: local-app — XML mode works on exported FCPXML files; Live Mode requires macOS with Final Cut Pro 10.4+ running and a one-time Automation permission grant

Sample tools

inspectdiagnoseeditmarkgeneratetranscriptdeliver

Field notes

Rename direction: `DareDev256/fcpxml-mcp-server` is the OLD path and 301-redirects to the canonical `DareDev256/fcp-mcp-server`; use the latter. Name collision warning: the `fcp-mcp` entry in this directory is dreliq9's separate Final Cut server, not this one. Re-checked 12 Oct 2026: MIT, v0.26.0 released Oct 9 2026 and matched on PyPI, 122 stars, Python >=3.10, MCP SDK 1.21.1 through 2.x, Final Cut Pro 10.4–12.x (live-verified on 12.2), reads FCPXML v1.8–1.14. Ten minor versions since August, and the surface has doubled: 15 grouped tools now (the original seven plus preview, watch, index, scenes, organize, find, view, gen) dispatch 102 operations; FCP_MCP_LEGACY_TOOLS=1 adds 71 flat schemas. The new `gen` group calls paid generation APIs (fal, Runway, Luma, Gemini, ElevenLabs) when you supply their keys, with spend capped by FCP_MCP_GEN_MAX_USD (default $5) — a cost surface the earlier build did not have. Optional extras install with `uvx --from "fcp-mcp-server[intelligence,transcribe]" fcp-mcp-server`. Writes stay beside the source file with `_modified` suffixes and are journaled for undo. Read the sandbox docs before pointing it at a shared machine: FCP_PROJECTS_DIR confines *listing* only and never restricts which files a tool can open — the opt-in FCP_PROJECTS_DIRS (PATH-separated roots, new in 0.16.0) is the variable that actually confines reads, and it is off by default. This is not an in-FCP plugin: Live Mode pushes XML into Final Cut via an Apple event, but current timelines still come back by manual File > Export XML.

Also in Editing & Post

Pairs well with