fcp-mcp — Final Cut Pro MCP Server
io.github.dreliq9/fcp-mcp·v0.2.0·10 starsFinal Cut Pro MCP — 88 tools: FCPXML engine, live FCP control, media analysis, puppets.
10 stars59 downloads/wk
Reviews
Write oneNobody has reviewed fcp-mcp — Final Cut Pro MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
fcp-mcp — Final Cut Pro MCP Server tools (88, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
compressor_encodeEncode a file using Compressor CLI.
compressor_list_settingsList available Compressor encoding presets.
fcp_discover_effectsList available FCP effects and transitions by scanning known locations.
fcp_export_xmlTrigger XML export in FCP via menu automation (requires Accessibility permissions).
fcp_get_app_stateGet FCP application state — version, frontmost status.
fcp_get_eventsGet events in a library (or all libraries if name not specified).
fcp_get_librariesGet all open libraries in Final Cut Pro (requires FCP to be running).
fcp_get_projectsGet projects in an event (or all events if name not specified).
fcp_get_timeline_infoGet info about the current/first timeline in FCP.
fcp_import_xmlImport an FCPXML file into Final Cut Pro.
fcp_is_runningCheck if Final Cut Pro is currently running.
fcp_keyboard_shortcutwrite actionSend a keyboard shortcut to FCP.
fcp_list_motion_templatesList installed Motion templates (titles, transitions, generators, effects).
fcp_list_share_destinationsList configured FCP share destinations.
fcp_menu_commandwrite actionExecute any FCP menu command by path.
fcp_navigateNavigate to a specific timecode in FCP.
fcp_open_libraryOpen a FCP library file.
fcp_playbackControl FCP playback.
fcp_redoRedo the last undone action in FCP.
fcp_select_toolSwitch FCP editing tool.
fcp_shareTrigger a share/export from FCP.
fcp_undoUndo the last action in FCP.
fcpxml_add_audioAdd an audio clip to the timeline.
fcpxml_add_keywordAdd a keyword to a clip.
fcpxml_add_markerAdd a marker to a clip.
fcpxml_add_titleAdd a title clip to the timeline.
fcpxml_add_transitionwrite actionInsert a transition after a clip.
fcpxml_analyze_pacingAnalyze shot pacing — average/median shot length, distribution histogram.
fcpxml_apply_templateApply an FCPXML template to a set of clips.
fcpxml_assign_roleSet the role on a clip (e.g., "Dialogue", "Video", "Music", "Effects").
fcpxml_auto_rough_cutAuto-assemble clips into a rough cut timeline.
fcpxml_batch_add_markersAdd multiple markers at once.
fcpxml_batch_apply_transitionAdd transitions between all adjacent clips in the timeline.
fcpxml_batch_assign_rolesAssign roles to clips based on name matching rules.
fcpxml_batch_rename_clipsRename clips matching a pattern (substring replacement).
fcpxml_change_speedChange clip playback speed.
fcpxml_check_audio_levelsFlag clips with potential audio issues (volume adjustments, missing audio).
fcpxml_check_durationVerify the timeline fits a target duration.
fcpxml_check_frame_ratesDetect mixed frame rate issues in the timeline.
fcpxml_check_media_linksVerify all referenced media files exist on disk.
fcpxml_check_safe_zonesCheck for clips with transforms that might push content outside safe zones.
fcpxml_create_projectwrite actionCreate a new empty FCPXML project file.
fcpxml_create_timelinewrite actionBuild a timeline from a list of clip definitions.
fcpxml_delete_clipswrite actionRemove clips from the timeline by name.
fcpxml_detect_duplicatesFind clips that use the same source media.
fcpxml_detect_flash_framesFind clips shorter than max_frames (potential flash frames / accidental edits).
fcpxml_detect_gapsFind all gaps in the timeline.
fcpxml_diffCompare two FCPXML files and show differences.
fcpxml_export_edlExport timeline as EDL (Edit Decision List).
fcpxml_export_fcp7Convert FCPXML to FCP7 XML format (compatible with Premiere Pro and Avid).
fcpxml_export_resolveConvert FCPXML to DaVinci Resolve-compatible format (FCPXML v1.9).
fcpxml_fill_gapsReplace all gaps in the timeline with clips from a specified asset.
fcpxml_fix_flash_framesAuto-fix flash frames by extending very short clips to minimum duration.
fcpxml_generate_montageGenerate a montage/highlight reel with uniform clip durations and transitions.
fcpxml_import_edlConvert an EDL (Edit Decision List) to FCPXML.
fcpxml_import_srtConvert SRT subtitles to title clips and add to timeline.
fcpxml_list_clipsList all clips in the timeline with timecodes, durations, and roles.
fcpxml_list_effectsList all effects and transitions applied to clips.
fcpxml_list_markersList all markers, chapter markers, and keywords across all clips.
fcpxml_list_rolesList all roles and subroles used in the timeline.
fcpxml_list_templatesList available FCPXML template files.
fcpxml_parseParse an FCPXML file and return a structure summary.
fcpxml_qc_reportGenerate a comprehensive quality check report for the timeline.
fcpxml_reformatReformat a timeline for a different aspect ratio (e.g., 16:9 → 9:16 for vertical).
fcpxml_remove_silencewrite actionRemove gaps longer than the threshold from the timeline.
fcpxml_reorder_clipsReorder clips in the primary spine to match the given name order.
fcpxml_save_templateSave the current FCPXML structure as a reusable template.
fcpxml_split_clipSplit a clip at a given offset within the clip.
fcpxml_timeline_statsGet comprehensive timeline statistics — duration, clip count, resolution, pacing, etc.
fcpxml_trim_clipTrim a clip's source in/out points.
fcpxml_validateValidate FCPXML structure and report errors/warnings.
media_audio_to_midiTranscribe audio to MIDI using basic-pitch (ML audio transcription).
media_detect_beatsDetect beat positions in audio/music files.
media_detect_silenceDetect silent sections in audio/video files.
media_extract_audioExtract audio track from a video file.
media_extract_thumbnailExtract a frame thumbnail from video at a specific time.
media_extract_thumbnailsExtract thumbnails at regular intervals (contact sheet / storyboard).
media_infoGet detailed media file info (codec, resolution, duration, bitrate, etc.).
media_list_streamsList all audio, video, and subtitle streams in a media file.
media_loudnessAnalyze audio loudness (EBU R128 / LUFS).
media_scene_detectDetect scene changes in video.
puppet_animateBuild a puppet scene with custom keyframe animations.
puppet_build_sceneBuild an FCPXML timeline from one or more puppet rigs.
puppet_create_humanoid_rigwrite actionCreate a standard 6-part humanoid rig from a folder of images.
puppet_create_rigwrite actionDefine a puppet character rig from body parts.
puppet_list_presetsList all available puppet animation presets with descriptions.
puppet_multi_sceneBuild a multi-scene puppet animation with different presets per scene.
puppet_preset_motionBuild a puppet scene with a preset motion applied.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan21 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 46 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How fcp-mcp — Final Cut Pro MCP Server compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 48,255 servers
- Tools
- 88
- the typical server has 7
- Tools that change things
- 10%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 10
- more than 88% of 28,688 servers
- Downloads a week
- 59
- more than 48% of 12,191 servers with a package
What its tools let an agent do: 79 read · 9 change
Install fcp-mcp — Final Cut Pro MCP Server in Claude Code, Cursor or VS Code
claude mcp add fcp-mcp -- uvx fcp-mcp
What the publisher says
From the fcp-mcp — Final Cut Pro MCP Server repository's README, as published. We do not edit it. Read it on GitHub
fcp-mcp — Final Cut Pro MCP Server
<!-- mcp-name: io.github.dreliq9/fcp-mcp -->
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.
Version 0.3.0 freezes a 94-tool catalog 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 evidenceStart here:
- Documentation index
- First run
- Compatibility
- Support
- Security
- v0.3.0 release and fresh product evidence
- Agent operating guide
- Production workflow recipes
- v0.3 changelog
- v0.3.0 review evidence
Project Structure
fcp-mcp/
├── src/fcp_mcp/
│ ├── __init__.py
│ ├── __main__.py # python -m fcp_mcp CLI
│ ├── cli.py # serve, doctor, doctor --json, --version
│ ├── config.py # immutable environment configuration
│ ├── contracts.py # stable errors + structured diagnostics
│ ├── diagnostics.py # non-mutating runtime readiness checks
│ ├── observability.py # text/JSON transaction events
│ ├── server.py # MCP v2 entry and profile-selected handlers
│ ├── tool_metadata.py # MCP safety annotation presets
│ ├── automation/
│ │ └── osascript.py # argv-isolated AppleScript/JXA runner
│ ├── security/
│ │ └── paths.py # allowed-root and output policy
│ ├── fcpxml/
│ │ ├── parser.py # FCPXML → Python object tree
│ │ ├── writer.py # transactional XML mutation/writing
│ │ ├── models.py # TimeValue, Timecode, Clip, Timeline, etc.
│ │ ├── time_utils.py # rational-arithmetic timecode
│ │ ├── analysis.py # pacing, flash frames, gaps, duplicates
│ │ ├── validator.py # DTD-style structural vShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
fcp-mcp — Final Cut Pro MCP Server: common questions
- Is fcp-mcp — Final Cut Pro MCP Server safe?
- Yes, by our scan: it is graded A (88/100). Read the fcp-mcp — Final Cut Pro MCP Server safety report
- How do I install fcp-mcp — Final Cut Pro MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does fcp-mcp — Final Cut Pro MCP Server need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is fcp-mcp — Final Cut Pro MCP Server maintained?
- The last commit was 83 days ago (2026-08-13). The latest release is v0.2.0.
- How does fcp-mcp — Final Cut Pro MCP Server compare with other MCP servers?
- safety score 88/100 (higher than 75% of 48,255 servers); tools 88 (the typical server has 7); tools that change things 10% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.