Skip to content

Connect Paper to Zed

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

  • Zed 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 Zed

    Add it to your settings

    Run zed: open settings file from the command palette and add this inside the top-level object, next to your other settings.

    ~/.config/zed/settings.json
    {
      "context_servers": {
        "paper": {
          "command": "/path/to/home/.paper/bin/paper",
          "args": [
            "mcp"
          ]
        }
      }
    }
    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

    Open Settings → AI → MCP Servers. A green dot next to the server means it is running.

  3. Step 3: Try a first request

    Ask Zed something that only works with Paper connected:

    Say to Zed
    Look at the selected artboard in Paper and describe its layout, colours and type styles.

If it doesn't work

  • Zed reads MCP servers from the context_servers key, not mcpServers. Servers under any other key are ignored.
  • Run zed: open settings file from the command palette to edit your settings.
  • Zed asks before running each tool. Change this with agent.tool_permissions in your settings.