Compositor — Claude Code MCP server: what it does, how to install
An MCP server for reading and editing Compositor projects through an agent: layers, folders, masks, transforms, previews, exports. Useful when a layout needs retouching without opening the Mac editor manually.
MIT ★ 8 updated 2026-09-25
claude mcp add compositor -- npx -y compositor-mcpWhat Compositor does
It works directly with the .comp package: a manifest.json file plus one PNG per layer. The agent does not need a running Compositor app to inspect or change a project. It reads the files, edits the layer data, and writes them back for later use in Compositor.
The server includes tools such as create_project, add_image_layer, set_layer, move_layer, remove_layer, replace_layer_image, set_layer_mask, resize_canvas, render_preview, export_flattened, export_layer, and open_in_compositor. Preview output comes back as a PNG image, so the model can see the flattened composition before exporting. Fields the tool does not understand, like text, shapes, effects, or adjustment layers, stay intact on a round trip.
Installation requires Node.js 20 or later. One real limitation: the preview renderer skips clipping masks, adjustment layers, and layer effects. Compositor also does not watch project files, so after the agent edits an open document you have to close and reopen it.
What it helps with
- create a new .comp document with a solid background
- add photos and logos as layers with blend modes
- export a layer's pixels or mask to a file
- reorder layers and folders before opening the result
- attach an inverted grayscale mask to a layer
Example prompts for the agent
- Change
logoto 60% opacity and move it to the top left. - Export
poster.compas a flattened JPEG and return the file.
How to install Compositor
Platform CLI
claude mcp add compositor -- npx -y compositor-mcpPlatform CLI
codex mcp add compositor -- npx -y compositor-mcpConfig file
{
"mcpServers": {
"compositor": {
"command": "npx",
"args": [
"-y",
"compositor-mcp"
]
}
}
}Config file
{
"servers": {
"compositor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"compositor-mcp"
]
}
}
}Platform CLI
gemini mcp add compositor npx -y compositor-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Compositor
How do I install Compositor in Claude Code?
Make sure Node.js 20 or later is available, then run claude mcp add compositor -- npx -y compositor-mcp.
What does Compositor do?
It lets an AI agent read and edit .comp projects: inspect layers, move them, set masks, render a preview, and export PNG or JPEG. Compositor itself is only needed to view the result.
Why doesn't the preview match Compositor's export?
The built-in preview renderer does not yet handle clipping masks, adjustment layers, or layer effects, and the tool reports what it skipped. Use Compositor's own export as the reference.