Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add compositor -- npx -y compositor-mcp
Open on GitHub

What 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 logo to 60% opacity and move it to the top left.
  • Export poster.comp as a flattened JPEG and return the file.

How to install Compositor

Platform CLI

claude mcp add compositor -- npx -y compositor-mcp

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open