Connect Paper to Conductor
AI-native design canvas built on HTML and CSS. Its MCP server lets agents read artboards, export JSX and write new designs straight onto the canvas.
MCP serverOfficialChecked 2026-11-16
Before you start
- Conductor installed (see its MCP documentation (opens in a new tab)).
- Paper is available on macOS, Windows, Linux and the web.
- Install the Paper CLI;
~/.paper/bin/paper mcpstarts a stdio relay to the open Paper file. Use the full path: on some Linux systemspaperon PATH is libpaper's paper-size tool. Observed working on Linux.
Step 1: Add Paper to Conductor
For Claude Code sessions
Saves the server to your Claude Code user settings, so every Conductor workspace gets it.
Terminal claude mcp add --scope user paper -- ~/.paper/bin/paper mcpFor Codex sessions
Saves the server to
~/.codex/config.toml, which Codex sessions in every workspace read.Terminal codex mcp add paper -- ~/.paper/bin/paper mcpOr share it with your team
Add this to
.mcp.jsonat the project root and commit it. Claude Code sessions in every workspace on that branch pick it up..mcp.json { "mcpServers": { "paper": { "type": "stdio", "command": "${HOME}/.paper/bin/paper", "args": [ "mcp" ] } } }Or edit Codex's config file
Add this to
~/.codex/config.toml.~/.codex/config.toml [mcp_servers.paper] command = "/path/to/home/.paper/bin/paper" args = ["mcp"]Good to know- Start a new session in Conductor after adding a server, so the agent loads it.
- In the config file, replace
/path/to/homewith your home folder's full path, for example/Users/youor/home/you.
Step 2: Check it's connected
Terminal claude mcp listIn a Conductor session, click the plug icon in the composer or run
/mcp-statusto see each server's status.Step 3: Try a first request
Ask Conductor something that only works with Paper connected:
Say to Conductor Look at the selected artboard in Paper and describe its layout, colours and type styles.
If it doesn't work
- Conductor has no MCP settings of its own. Claude Code and Codex sessions load the same servers they use outside Conductor.
- Each workspace is a separate git worktree. Servers added with plain
claude mcp addonly apply to the folder you ran it in, so use--scope useror a committed.mcp.json. - Conductor runs on macOS. Environment variables for local servers can go in
.conductor/settings.local.toml, under[environment_variables].






