fcpxml-mcp-server

Overview

FCPXML MCP Server is a comprehensive bridge between Final Cut Pro and AI systems, providing 53 tools that transform timeline XML into structured data that AI assistants can read, edit, and generate. The server allows users to export XML from Final Cut Pro, make complex edits through natural language prompts, then import modified XML back into FCP. It handles operations like batch marker insertion, timeline health checks, duplicate detection, gap fixing, and rough cut generation with frame-accurate precision. The implementation maintains rational fraction time values to prevent rounding errors during trim, split, and speed operations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• analyze_timeline

  Provides a comprehensive breakdown of the timeline including clips, duration, frame rate, markers, and more

  Try:Give me a full breakdown of ProjectX.fcpxml — clips, duration, frame rate, markers, everythingTry:Show me stats for my current timeline
• detect_flash_frames

  Detects clips in the timeline that are shorter than a specified duration threshold

  Try:Find all flash frames in my timelineTry:Show me clips under 3 frames
• detect_gaps

  Identifies unintentional gaps or empty spaces in the timeline

  Try:Find all gaps in my editTry:Are there any black sections I missed?
• validate_timeline

  Performs a comprehensive health check and scoring of the timeline

  Try:Run a health check on my wedding editTry:How's my timeline scoring?
• list_markers

  Lists all markers on the timeline with their positions and values

  Try:Show me all markers on my timelineTry:List all chapter markers
• fix_flash_frames

  Automatically fixes detected flash frames by extending adjacent clips

  Try:Fix all flash frames in my timelineTry:Eliminate clips under 2 frames
• fill_gaps

  Automatically fills timeline gaps by extending previous clips

  Try:Fill all gaps in my timelineTry:Remove empty sections between clips
• export_edl

  Exports the timeline as an Edit Decision List (EDL)

  Try:Export an EDL for my timelineTry:Create a cut list for my project
• add_marker

  Adds a marker at a specified position on the timeline

  Try:Add a marker at 1:30 with the label 'interview start'Try:Put a chapter marker at the beginning of segment 2
• auto_rough_cut

  Generates an automated rough cut based on specified criteria

  Try:Build a 60-second rough cut from clips tagged 'Interview'Try:Generate a montage from all B-roll clips
• reformat_timeline

  Converts the timeline to a different aspect ratio

  Try:Convert my 16:9 timeline to 9:16 for InstagramTry:Reformat to square aspect ratio
• import_srt_markers

  Imports chapter markers from an SRT subtitle file

  Try:Import markers from my-subtitles.srtTry:Add chapter markers from this transcript

Comparable tools

Installation

git clone https://github.com/DareDev256/fcpxml-mcp-server.git
cd fcpxml-mcp-server
pip install -e .

{
  "mcpServers": {
    "fcpxml": {
      "command": "python",
      "args": ["/path/to/fcpxml-mcp-server/server.py"],
      "env": { "FCP_PROJECTS_DIR": "/Users/you/Movies" }
    }
  }
}

FAQ

Is this a Final Cut Pro plugin?

No, this is not a plugin that runs inside Final Cut Pro. It works with exported XML files outside of FCP.

Can I make creative editing decisions with this server?

No, this server is for batch operations and data manipulation. Creative decisions requiring visual feedback should still be made directly in Final Cut Pro.

Compare fcpxml-mcp-server with