Skip to content

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 mcp starts a stdio relay to the open Paper file. Use the full path: on some Linux systems paper on PATH is libpaper's paper-size tool. Observed working on Linux.
  1. 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 mcp

    Or edit the config file

    Add this to opencode.json at 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/home with your home folder's full path, for example /Users/you or /home/you.
  2. Step 2: Check it's connected

    Terminal
    opencode mcp list

    Start OpenCode in the project; the server's tools are available to the agent straight away.

  3. 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.json from the project root, or ~/.config/opencode/opencode.json for every project.
  • Environment variables use the {env:NAME} syntax inside the config file.
  • Servers that need a sign-in: run opencode mcp auth <name>.