
fcp-mcp — Final Cut Pro MCP Server
Wraps Final Cut Pro's entire stack into 88 MCP tools: a rational-arithmetic FCPXML engine for frame-accurate parsing and editing, AppleScript bindings for live library and playback control, ffprobe-backed media analysis, and a parametric puppet system that generates character rigs in pure XML. You can ask Claude to open a library, detect flash frames in the active timeline, patch the FCPXML, reimport it, trigger a Share action, and dispatch the result to Compressor without leaving the conversation. Includes cross-NLE export to Resolve and Premiere, QC reports that catch offline media and audio peaks before you render, and hardened XML parsing via defusedxml. Designed for editors who want agents to handle multi-step post workflows end to end.
- tools
- 21
- transport
- STDIO
- env var
- 1
- last updated
- Apr 23, 2026
Tools
21 toolsPublic tool metadata for what this MCP can expose to an agent.
fcp_doctorCombines with 96 domain tools across 14 functional categories in the full catalog.
Combines with 96 domain tools across 14 functional categories in the full catalog.
No parameter schema in public metadata yet.
fcpxml_detect_flash_framesUsed in the example workflow to find flash frames in a FCPXML file.
Used in the example workflow to find flash frames in a FCPXML file.
No parameter schema in public metadata yet.
fcpxml_workflow_prepareRuns a fixed, bounded edit graph and stores the candidate, semantic diff, validation evidence, and event chain beneath the private state directory.
Runs a fixed, bounded edit graph and stores the candidate, semantic diff, validation evidence, and event chain beneath the private state directory.
No parameter schema in public metadata yet.
fcpxml_workflow_statusDefault profile workflow tool for checking a durable edit run.
Default profile workflow tool for checking a durable edit run.
No parameter schema in public metadata yet.
fcpxml_workflow_commitCommits a reviewed candidate, passing the exact returned candidate hash as expected_candidate_sha256.
Commits a reviewed candidate, passing the exact returned candidate hash as expected_candidate_sha256.
No parameter schema in public metadata yet.
fcpxml_workflow_cancelDefault profile workflow tool for cancelling a durable edit run.
Default profile workflow tool for cancelling a durable edit run.
No parameter schema in public metadata yet.
fcpxml_export_resolveExports the same timeline as DaVinci Resolve-flavored XML.
Exports the same timeline as DaVinci Resolve-flavored XML.
No parameter schema in public metadata yet.
fcpxml_export_fcp7Exports the same timeline as Premiere-compatible XMEML (FCP7 format).
Exports the same timeline as Premiere-compatible XMEML (FCP7 format).
No parameter schema in public metadata yet.
fcpxml_export_edlExports the same timeline as a flat EDL.
Exports the same timeline as a flat EDL.
No parameter schema in public metadata yet.
fcpxml_qc_reportProduces a Markdown validation summary, timeline statistics, gaps, flash frames, duplicate sources and pacing distribution.
Produces a Markdown validation summary, timeline statistics, gaps, flash frames, duplicate sources and pacing distribution.
No parameter schema in public metadata yet.
fcpxml_prepare_importPrepares one named event/project for import without contacting Final Cut, producing a private artifact and plan hash.
Prepares one named event/project for import without contacting Final Cut, producing a private artifact and plan hash.
No parameter schema in public metadata yet.
fcp_request_importSends one approved Open Document AppleEvent to import a prepared artifact, given prepared_id and expected_plan_sha256.
Sends one approved Open Document AppleEvent to import a prepared artifact, given prepared_id and expected_plan_sha256.
No parameter schema in public metadata yet.
fcp_reconcile_importReads app metadata for a prepared import and updates private bookkeeping.
Reads app metadata for a prepared import and updates private bookkeeping.
No parameter schema in public metadata yet.
fcp_import_xmlExisting import tool that is unchanged by the import bridge.
Existing import tool that is unchanged by the import bridge.
No parameter schema in public metadata yet.
fcp_open_libraryOpens a library via AppleScript live control.
Opens a library via AppleScript live control.
No parameter schema in public metadata yet.
fcp_get_timeline_infoReturns current project, active range and playhead.
Returns current project, active range and playhead.
No parameter schema in public metadata yet.
fcp_playbackControls playback with play, pause, goto and in_out actions.
Controls playback with play, pause, goto and in_out actions.
No parameter schema in public metadata yet.
fcp_menu_commandTriggers a Final Cut Pro menu command by path.
Triggers a Final Cut Pro menu command by path.
No parameter schema in public metadata yet.
fcp_keyboard_shortcutSends a keyboard shortcut to Final Cut Pro.
Sends a keyboard shortcut to Final Cut Pro.
No parameter schema in public metadata yet.
fcp_shareTriggers a Share destination, such as YouTube 4K.
Triggers a Share destination, such as YouTube 4K.
No parameter schema in public metadata yet.
fcp_discover_effectsLists every installed effect, transition and title.
Lists every installed effect, transition and title.
No parameter schema in public metadata yet.
Sponsors
Configuration
FCP_MCP_OUTPUT_DIRDirectory for modified FCPXML outputs (default: alongside input with _modified suffix)
Readme
fcp-mcp — Final Cut Pro MCP Server
Trusted, local, human-approved Final Cut Pro workflows. fcp-mcp inspects, generates, and transactionally edits FCPXML, then optionally hands verified artifacts to Final Cut Pro. The default profile never performs direct live or offline mutation.
This development catalog adds three import-bridge tools to the v0.3.0 baseline across four profiles. It is a bounded FCPXML interchange and tested Final Cut Pro handoff surface—not a claim of complete autonomous Final Cut Pro control. The default workflow is inspect, prepare, review, hash approval, then commit.
You: "Find and repair flash frames in hero.fcpxml."
Claude → fcpxml_detect_flash_frames → fcpxml_workflow_prepare
→ review semantic diff + candidate hash → fcpxml_workflow_commit
Result: the reviewed candidate is atomically committed with durable evidence
Start here:
Details
- Repository
- github.com/dreliq9/fcp-mcp
- Category
- Media & Entertainment
- Package
fcp-mcp- Transport
- STDIO
- Registry
- MCP registry, active