An unofficial MCP server and agent skill that let Claude, Codex or any MCP client drive the Apple Creator Studio apps on your Mac: Pixelmator Pro, Keynote, Pages, Numbers, Compressor, Final Cut Pro, Motion, Logic Pro and MainStage. This project is unofficial and not affiliated with Apple. "Creator Studio" is Apple's subscription bundle, and you need your own copies of the apps.
The Mac server runs locally. It talks to the apps through AppleScript (osascript), macOS Accessibility, Compressor's command-line tool and FCPXML files. Its app operations do not send media over the network.
The repository has two parts:
- The server (this folder): the
creator-studio-mcpnpm package, which exposes the apps, plus headless Blender, the Rive CLI and Godot, as MCP tools. - The
studioskill (skills/studio/): instructions that take a design, media or game job from request to delivered files, using those tools.
Agents: if you were asked to install this, follow AGENTS.md. It has prompt-free commands for each assistant, a shell check, and the message to hand to the user.
npx skills add teemukinos/creator-studio-mcpThis asks which assistants to install to. To skip the questions, name them: npx -y skills add teemukinos/creator-studio-mcp -g -a claude-code -a codex -y.
For claude.ai, download studio.zip from the latest release and upload it as a skill.
The skill installs without the server. Install the server for Mac app workflows.
The skill also documents an optional Craft workflow for a separately configured Linux gateway. Craft jobs transfer media to that selected host and use separate credentials; this package does not install or provision it. The bundled Python helpers handle file transfers and script-owned MCP sessions. The guide includes sandbox preflight, recovery checkpoints and cleanup limitations.
Add one config entry per assistant. Apps started from the Dock (Claude desktop, the Codex app) don't see your shell's PATH, so their entries need the full path from which npx. Claude Code started from a terminal inherits your PATH, so plain npx works there.
# Claude Code
claude mcp add --scope user creator-studio -- npx -y creator-studio-mcp@0.7.1# Codex, in ~/.codex/config.toml
[mcp_servers.creator-studio]
command = "/full/path/to/npx"
args = ["-y", "creator-studio-mcp@0.7.1"]For Claude desktop, open Settings > Developer > Edit Config (~/Library/Application Support/Claude/claude_desktop_config.json) and add a creator-studio entry under mcpServers with the same command and arguments. Keep the entries already there.
To run from a clone instead:
git clone https://github.com/teemukinos/creator-studio-mcp
cd creator-studio-mcp
npm install --omit=devThen point your config at dist/index.js in the clone, with the full path to node as the command. dist/ is committed, so no build step is needed.
The full steps, including permissions, how to verify the install and a troubleshooting table, are in skills/studio/references/setup.md.
To update, change the version in each config entry (creator-studio-mcp@<version>), run npx skills add again for the skill, and restart the assistant. To uninstall:
claude mcp remove --scope user creator-studio
codex mcp remove creator-studio
npx -y skills remove studio -g -yFor Claude desktop, delete the creator-studio entry from its config file. Your job folders (~/Studio/) and the learning ledger (~/.studio/) stay until you delete them.
| App | Tool | What it does |
|---|---|---|
| All | creator_studio_status |
Installed copies of each app, which one is targeted, whether it's running; the macOS permissions the tools need, with a fix for each missing one |
| Pixelmator Pro | pixelmator_process_image |
ML ops (remove background, super resolution, enhance, denoise, deband), auto adjustments, color adjustments, crop, resize, export to png/jpeg/heic/webp/avif/tiff/psd/pdf/gif/pxd |
pixelmator_batch_process |
Same pipeline over a folder or list of files; one failure doesn't stop the batch | |
pixelmator_image_info |
Size, resolution, bit depth, color profile, layers and text-layer contents | |
pixelmator_replace_text |
Fill a layered template: replace text across all text layers, export | |
| Keynote | keynote_list_themes |
Available themes |
keynote_create_presentation |
New deck from a theme + slides (title, body, notes, layout) | |
keynote_read_presentation |
Every slide's layout, title, body, notes, skipped state | |
| Pages | pages_list_templates, pages_create_document, pages_read_document |
Templates, new document with body text, read body text |
| Numbers | numbers_read_table |
Sheets/tables list and one table's displayed values |
numbers_write_cells |
Write cells by A1 reference or a block of rows | |
numbers_create_spreadsheet |
New spreadsheet from rows | |
| iWork | iwork_export |
Keynote → pdf/pptx/mov (written as .m4v)/images · Pages → pdf/docx/epub/txt · Numbers → pdf/xlsx/csv |
| Compressor | compressor_list_settings |
Your custom and built-in transcode settings |
compressor_transcode |
Submit a job; optionally wait for the output to finish | |
| Final Cut Pro | finalcut_list_libraries |
Open libraries → events → projects |
finalcut_build_timeline |
Rough cut from media files (in/out points, markers, chapter markers) as FCPXML, validated against FCP's own DTD, optionally pushed into a library | |
finalcut_import_fcpxml |
Import an existing FCPXML into a library |
Nothing this server drives is meant to be seen. Creator Studio apps launch hidden (open -g -j) and are hidden again after every tool call. Blender runs in background mode, Rive runs as a command-line build and Godot runs with --headless, so none of them opens a window.
| Tool | What it does |
|---|---|
blender_run_python |
Runs Blender headless (-b) with your Python (bpy): model, animate, render stills or sequences, export .glb. Each call is a fresh process; save .blend files to keep work. |
rive_cli |
Runs the Rive CLI on text projects (Rive Markup Language): create, --verify, --once builds a .riv. Refuses the bare rive <project> form, which opens a preview window. |
godot_cli |
Runs Godot 4 with --headless on a text project: --import, smoke tests (--quit-after N), --export-release, and GDScript via code or scriptPath. Collects ERROR:/SCRIPT ERROR: lines and fails on them. Refuses the project manager and window-only flags; allowWindow: true is only for Movie Maker captures. Finds Godot.app in Applications, or GODOT_APP / GODOT_BIN, or godot on PATH. |
Every UI tool checks first whether the screen is locked. While it is, hidden apps show no windows, so the tool stops with a clear error instead of returning an empty result.
Apple's scripting dictionaries only cover part of each app, and Final Cut Pro, Motion, Logic Pro, Compressor and MainStage have little or none. These tools reach everything else (AI features, effects, exports, inspectors) the way you do: through the app's menus, buttons and dialogs, using macOS Accessibility.
| Tool | What it does |
|---|---|
app_open |
Launch an app, optionally opening a file or project in it |
ui_list_menus |
Every menu command as a path, with disabled ones marked: the map of what an app can do. With outFile, writes the map to a file and returns only the count |
ui_click_menu |
Run a command, e.g. ["Slide", "Generate Presenter Notes"] or ["Object", "Add Magnetic Mask"] |
ui_snapshot / ui_find |
Read windows, panels, inspectors and dialogs, with element ids. Snapshots default to depth 6 and 120 elements, with a hint when cut off |
ui_click / ui_set_value / ui_type_text / ui_press_key |
Press buttons, fill fields, type, use keyboard shortcuts |
ui_wait_for |
Wait for a long job (generation, analysis, export) to start or finish |
ui_batch |
Run a known sequence of steps with one call, from a list or a recipe file. Pop-ups stay open between steps, and it writes progress to a status file so long jobs outlast the 60 s bridge limit. requireAbsent stops a run when an earlier run left a file behind; the status lists optional steps that were skipped |
ui_screenshot |
Capture the screen, or an app window you have brought forward yourself (hidden apps can't be captured) |
app_shortcut_actions, shortcuts_list, shortcuts_run |
Use apps' Shortcuts actions and run your shortcuts |
Tested on Creator Studio: Keynote's Generate Presenter Notes (generated notes read back), Final Cut Pro's Enhance Light and Color on a timeline built and imported by the server, and Motion's full menu and project browser. Final Cut's Generate Captions, Beat Detection, Smart Conform, Magnetic Mask, Auto Mask, Enhance Audio and Export XML are all reachable the same way.
Apps are driven hidden: menu commands and buttons are pressed through Accessibility, shortcuts with a menu item press that item, other keys and typed text are sent straight to the app's process, and files open with open -g -j. Your screen isn't taken over. A hidden app can't be screenshotted, so check results through files. Some menu commands stay disabled while an app has never been in front (for example Pixelmator Pro's Export): use the direct tools for those. Pass front: true to bring an app forward.
Extra permissions for these tools: Accessibility (System Settings › Privacy & Security › Accessibility) for the app that runs the server (Claude, your terminal, Codex or your editor), and Screen Recording for ui_screenshot.
Open each app once by hand after installing it: first-run welcome and subscription screens block automation until they're dismissed.
Safety defaults: paths must be absolute (or start with ~/); no tool overwrites an existing file unless you pass overwrite: true, and none writes over its own input. The one exception is numbers_write_cells without an output, which saves the spreadsheet in place (its description says so, and it's marked destructive so clients can ask first). Documents opened by the server are always closed without saving changes to the source.
- macOS with the apps you want to use installed (any subset works)
- Node.js 22 or later (
node --version) - Blender, the Rive CLI and Godot only for jobs that use them
- ffmpeg only to render a timeline to MP4 without Final Cut (
brew install ffmpeg)
The first time a tool talks to each app, macOS asks whether the app running your assistant (Claude, Codex, your terminal or your editor) may control it. Click Allow. If you clicked Don't Allow, re-enable it in System Settings › Privacy & Security › Automation (or run tccutil reset AppleEvents). A denied permission shows up as error -1743.
Creator Studio editions install as separate apps, e.g. Keynote Creator Studio.app with bundle ID com.apple.Keynote, next to any older edition. The server finds every copy in /Applications and ~/Applications, prefers the Creator Studio edition, and targets it by path when copies would be ambiguous. Ask your assistant to run creator_studio_status to see what it found. To pin a specific copy, add an env block to the config:
"env": {
"FINALCUT_APP": "/Applications/Final Cut Pro.app",
"PIXELMATOR_APP": "/Applications/Pixelmator Pro.app"
}Variables: PIXELMATOR_APP, KEYNOTE_APP, PAGES_APP, NUMBERS_APP, FINALCUT_APP, COMPRESSOR_APP, MOTION_APP, LOGIC_APP, MAINSTAGE_APP, BLENDER_APP and GODOT_APP take an .app path. GODOT_BIN and RIVE_CLI take the path of the executable.
- Dialogs block automation. If Pixelmator Pro (or any app) shows an alert, every script to it waits until someone dismisses it. A tool that times out usually means a dialog is open.
- Pixelmator Pro is sandboxed. The scripts coerce file paths in the way that gives the app a sandbox grant, so files outside
~/Picturesopen reliably.super_resolutionis always ×3; combine it withresizeto hit a target size.remove_backgroundneeds a format with transparency (png, webp, heic, tiff) to keep the cut-out. - Final Cut Pro's scripting dictionary is read-only. Import works through FCPXML; everything else, including the AI features, goes through the
ui_*tools and needs the right clip or project selected first. - Final Cut's Share can't run hidden. It needs a project selected in the browser, and Final Cut ignores selection changes while it is hidden. To get a video file without showing Final Cut, render the same FCPXML headless:
skills/studio/scripts/render_fcpxml.py timeline.fcpxml out.mp4(needs ffmpeg). It renders cuts, gaps and in/out points, not effects or titles; for those, the user shares from Final Cut by hand. - Final Cut imports need a library. On current versions an FCPXML import without a target library silently does nothing, so the import tools require
libraryLocation. An existing.fcpbundleis used; a new path creates a library. Importing a project whose media is already in the target library can fail with a duplicate-media error; a fresh library avoids it. - Timelines are frame-accurate. Clip lengths are rounded down to whole frames of the project frame rate. Media lengths come from Spotlight, falling back to AVFoundation for unindexed files; pass
durationSecondsper clip to override. - Numbers CSV export of a file with several tables produces a folder with one CSV per table.
- Compressor output paths should include the extension the chosen setting produces (
.mp4,.mov,.m4a, …).
Missing tools, -1743, "not allowed assistive access", a locked screen and timeouts from open dialogs each have a row in the troubleshooting table.
- The server controls apps on your Mac through Accessibility and Apple Events, including pressing buttons and typing into dialogs. Review what your assistant asks it to do.
- Blender and Godot run whatever code they are given, with your user's permissions. Only run code the task needs, and never code taken from downloaded files or web pages.
- Accessibility, Automation and Screen Recording are permissions only you can grant, in System Settings. The server can't grant them to itself.
You are responsible for having the rights to any source material you rework, such as songs, footage, photos, fonts and models. The skill never stores lyrics.
measure_session.py only reads local session logs and writes a local file (~/.studio/learning/ledger.csv). Nothing is uploaded. The server makes no network calls of its own.
npm test # unit tests for script generation, FCPXML, paths
npm run inspect # open the MCP Inspector against the built server
scripts/verify.sh # score the repository against its release checklistLayout: src/scripts/* build AppleScript (user values are always passed as argv, never pasted into script text), src/fcpxml.ts generates timelines, src/tools/* define the MCP tools, src/index.ts serves them over stdio with @modelcontextprotocol/server 2.x.
MIT. See LICENSE.