DareDev256/fcp-mcp-server

Edit Final Cut Pro by talking to Claude, and watch the cut change.
One prompt, seven tool calls, and the timeline re-rendered inline after each
write. Every frame is the real ui://fcp/timeline app drawing a real
view_timeline result; the B-roll provider is mocked and the recording says
so on screen. Full-size mp4, re-recorded
with demo/hero/build.py.
See it. view returns the timeline as exact rational-time JSON, and a
host with MCP Apps draws it inline: lanes, thumbnails, markers, transcript
words, a playhead, buttons that call the other tools.
Cut it. 15 grouped tools, 102 operations: trims, splits, silence removal,
markers from transcripts and beats, rough cuts, keyframes and speed ramps,
transcript edits, cross-NLE export, and a push into a running Final Cut Pro.
Trust it. Every write is journaled with its sha256 and can be undone.
deliver refuses an unreviewed cut, expected_sha256 refuses a file that
changed under the model, and generation is quote-then-confirm under a
per-call cap. 182 adversarial-input security tests, defusedxml everywhere,
sandboxed writes, no private APIs, and a disclosure channel.
bash
claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server
Then File → Export XML… in Final Cut Pro, and ask Claude to work on the file.
## Proof
Real v0.25.0 output against a running copy of Final Cut Pro. A ten clip
timeline is read back off the document, a marker is placed on every cut, and
dialogue, music and effects roles are assigned across the clips. Final Cut is
open on the left the whole time and is never touched by hand. Screen recorded
from demo/session.sh, which calls the same handlers an MCP
client calls; each import is verified by polling Final Cut until the project
appears, so a delivered Apple event is never reported as a landed import.
The earlier terminal only demo is still at docs/assets/demo.gif.
Re-record it with vhs demo/demo.tape; the media is synthesised by ffmpeg at
run time, so there is no fixture to keep.
## Keyframes and speed curves
Contributed by @travisoa in
#26: the inspect
and edit groups include five video/audio animation actions and three speed
curve actions, imported into Final Cut Pro 12.4 without warnings. See
keyframe usage for installation and animation, and
speed curves for holds, sampled ramps, ripple and reset.
## Quick Start
### Claude Code (fastest)
bash
claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server
Or project-scoped — commit a .mcp.json so your whole team gets it:
json
"mcpServers": {
"fcpxml": {
"command": "uvx",
"args": ["fcp-mcp-server"],
"env": { "FCP_PROJECTS_DIR": "/Users/you/Movies" }
With media intelligence (beat detection) and transcript editing (local Whisper):
bash
claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx --from "fcp-mcp-server[intelligence,transcribe]" fcp-mcp-server
### Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
json
"mcpServers": {
"fcpxml": {
"command": "uvx",
"args": ["fcp-mcp-server"],
"env": { "FCP_PROJECTS_DIR": "/Users/you/Movies" }
### From source (contributors)
bash
git clone https://github.com/DareDev256/fcp-mcp-server.git
cd fcp-mcp-server
pip install -e .