Connect Paper to OpenCode
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
- OpenCode 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 OpenCode
Add it from the terminal
Run this in your project folder. It saves the server to the project's
opencode.json.Terminal opencode mcp add paper -- ~/.paper/bin/paper mcpOr edit the config file
Add this to
opencode.jsonat the project root.opencode.json { "$schema": "https://opencode.ai/config.json", "mcp": { "paper": { "type": "local", "command": [ "/path/to/home/.paper/bin/paper", "mcp" ], "enabled": true } } }Good to know- In the config file, replace
/path/to/homewith your home folder's full path, for example/Users/youor/home/you.
- In the config file, replace
Step 2: Check it's connected
Terminal opencode mcp listStart OpenCode in the project; the server's tools are available to the agent straight away.
Step 3: Try a first request
Ask OpenCode something that only works with Paper connected:
Say to OpenCode Look at the selected artboard in Paper and describe its layout, colours and type styles.
If it doesn't work
- OpenCode reads
opencode.jsonfrom the project root, or~/.config/opencode/opencode.jsonfor every project. - Environment variables use the
{env:NAME}syntax inside the config file. - Servers that need a sign-in: run
opencode mcp auth <name>.





