Log inSubmit server
Fcpxml MCP Server logo

Fcpxml MCP Server

by DareDev256

Edit, diagnose, preview, organize, and export Final Cut Pro timelines through FCPXML and MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Fcpxml MCP Server

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "daredev256-fcpxml-mcp-server": {
      "command": "uvx",
      "args": [
        "fcp-mcp-server"
      ],
      "env": {
        "FCP_PROJECTS_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

DareDev256/fcpxml-mcp-server connects MCP clients to Final Cut Pro workflows through exported FCPXML files. It can inspect and diagnose timelines, make non-destructive edits, generate rough cuts, add markers, transcribe media, render previews, and export to other NLE formats. Use it when timeline analysis, batch cleanup, transcript-driven editing, or structured delivery is more efficient through an AI client than manual editing. The server can also watch for Final Cut Pro exports and push XML into a running Final Cut Pro on macOS.

Use cases

  • Inspect a Final Cut Pro timeline for gaps, duplicates, flash frames, and pacing issues
  • Remove silence, repair flash frames, and fill timeline gaps in a new FCPXML file
  • Generate rough cuts, montages, chapter markers, or selects reels from source media
  • Edit interviews by transcript and remove filler words with local transcription
  • Export timelines to Resolve, FCP7 XML, EDL, CSV, or role-based stems

Key features

  • FCPXML timeline inspection and frame-accurate editing
  • Timeline diagnostics for gaps, flash frames, duplicates, silence, and beats
  • Transcript-based editing, marker import, and filler-word removal
  • Rough cuts, montages, compound clips, and A/B-roll generation
  • Proxy previews, scene detection, shot search, and source-media analysis
  • Cross-NLE export, Final Cut Pro delivery, organization, and undo journaling

Tools13

What Fcpxml MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~2.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

96/96 checks healthy over the last 48d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · fcp-mcp-server (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars130Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Tools exposed13Callable tools this server registers over MCP.
Directory activity14 viewsConfig copies, upvotes, and views on AllMCPs.

How Fcpxml MCP Server works

What DareDev256/fcpxml-mcp-server does

DareDev256/fcpxml-mcp-server gives an MCP client structured access to Final Cut Pro timelines. It reads exported FCPXML, represents clips and timing as structured data, and writes new XML files for edited results. The original project file is preserved while changes are written to a separate output.

Its grouped tools cover timeline inspection, quality checks, clip editing, markers, timeline generation, transcription, previews, delivery, indexing, scene detection, library organization, and natural-language shot search. Read-only inspection and diagnosis can be used before any write operation. The server can identify gaps, duplicate clips, flash frames, silence candidates, beat structure, short cuts, long clips, and differences between timelines.

How it works

Export an XML timeline from Final Cut Pro, point the MCP client at the server, and ask the client to analyze or modify the file. The server parses the XML into Python objects, applies operations, and saves a new FCPXML result that can be imported back into Final Cut Pro. Timeline times remain rational fractions rather than rounded decimal values, supporting frame-accurate operations across different frame rates.

The preview group can render a proxy video, contact sheet, frame, or filmstrip with waveform information without opening Final Cut Pro. preview_check helps verify that a requested change appears in the result. The watch group monitors the Final Cut Pro export folder and compares newly detected XML with the last file seen, supporting a push-edit-export round trip.

Setup and configuration

The documented quick-start path uses uvx and the FCP_PROJECTS_DIR environment variable:

Terminal
claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server

Claude Desktop can run the same command through its MCP configuration file. Source installation is also available with pip install -e ., followed by pointing the client at server.py. After installation, export a timeline from Final Cut Pro using File → Export XML….

Optional extras add media intelligence and local Whisper transcription:

bash
uvx --from "fcp-mcp-server[intelligence,transcribe]" fcp-mcp-server

Scene detection can use PySceneDetect when the scenes extra is installed, or ffmpeg otherwise. The index cache is stored under ~/.fcp-mcp/index.db; setting FCP_MCP_INDEX=off disables it without disabling the other tools.

Tools and capabilities

  • Inspect and diagnose: Read project structure, clips, roles, markers, effects, templates, keywords, pacing, gaps, duplicates, flash frames, silence, beats, and timeline differences.
  • Edit timelines: Insert, delete, trim, split, reorder, retime, remove silence, attach audio or B-roll, add transitions, assign roles, fill gaps, and repair flash frames.
  • Generate and mark: Build rough cuts, montages, A/B-roll structures, templates, compound clips, and markers from SRT, VTT, transcripts, or beat analysis.
  • Transcribe and search: Transcribe local media, edit by spoken content, remove filler words, search shots using transcripts and logged metadata, and assemble search results into a selects reel.
  • Preview and analyze media: Render proxies and contact sheets, inspect frames and source-media waveforms, detect scenes, and turn scene boundaries into markers or cuts.
  • Deliver and organize: Export CSV, EDL, FCP7 XML, Resolve XML, and role stems; reformat or relink media; push to Final Cut Pro; apply keywords, ratings, and roles; and review or undo recorded organization operations.

Limitations and notes

The workflow is based on FCPXML exchange rather than a Final Cut Pro plugin. Creative judgments such as color, framing, and motion still require human review. Delivery and push operations require a rendered preview unless confirm_unreviewed=true is supplied. Transcript editing and media intelligence use local processing options, while visual shot search requires a locally installed vision model for frame-based results.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Fcpxml MCP Server

DareDev256/fcpxml-mcp-server is an MCP server that connects Final Cut Pro workflows to exported FCPXML files and exposes tools for inspection, diagnosis, editing, markers, timeline generation, transcript changes, previews, indexing, scene detection, organization, shot search, and delivery. It can also push XML into a running Final Cut Pro.

Install it with `uvx` and set `FCP_PROJECTS_DIR`, for example `claude mcp add fcpxml -e FCP_PROJECTS_DIR=~/Movies -- uvx fcp-mcp-server`. Claude Desktop can use the equivalent MCP configuration, or contributors can install from source with `pip install -e .`.

Export the timeline from Final Cut Pro with `File → Export XML…`, then give the resulting FCPXML file to the MCP client for inspection, diagnosis, editing, or export. Import the generated XML back into Final Cut Pro when the operation is complete.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFcpxml MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/daredev256-fcpxml-mcp-server?style=directory)](https://allmcps.com/mcp/daredev256-fcpxml-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/daredev256-fcpxml-mcp-server"><img src="https://allmcps.com/api/badge/daredev256-fcpxml-mcp-server?style=directory" alt="Fcpxml MCP Server on AllMCPs" /></a>