finalcut-mcp

MCP server for Final Cut Pro Creator Studio — list libraries, events, projects, import/export media, and render via AppleScript and FCPXML.

Install

npm install
npm run build

Usage

npm start

Tools

| Tool | Description | |------|-------------| | finalcut_list_libraries | List all open libraries with names and IDs | | finalcut_list_events | List events in a library | | finalcut_list_projects | List projects in an event | | finalcut_get_project_info | Get project details: name, duration, timecode | | finalcut_open_library | Open a .fcpbundle library file | | finalcut_export_xml | Export project as FCPXML (UI scripting) | | finalcut_import_media | Import media files into an event (UI scripting) | | finalcut_render | Start render/export of current project (UI scripting) |

Notes

• Tools 1-5 use direct AppleScript via Final Cut Pro's scripting dictionary
• Tools 6-8 use UI scripting via System Events (requires Accessibility permissions)
• App target: Final Cut Pro Creator Studio (com.apple.FinalCutApp)

MCP Config

{
  "finalcut": {
    "command": "node",
    "args": ["/Volumes/Virtual Server/projects/finalcut-mcp/dist/index.js"]
  }
}