Skip to content

Connect Paper to VS Code

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

  • VS Code 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 VS Code

    Add it from the terminal

    Adds the server to your VS Code profile, so it works in every workspace.

    Terminal
    code --add-mcp '{"name":"paper","type":"stdio","command":"${userHome}/.paper/bin/paper","args":["mcp"]}'

    Or add it to the workspace

    Add this to .vscode/mcp.json and commit it to share it with your team.

    .vscode/mcp.json
    {
      "servers": {
        "paper": {
          "type": "stdio",
          "command": "${userHome}/.paper/bin/paper",
          "args": [
            "mcp"
          ]
        }
      }
    }
  2. Step 2: Check it's connected

    Run MCP: List Servers from the Command Palette, then open Copilot Chat in Agent mode and check the tools picker.

  3. Step 3: Try a first request

    Ask VS Code something that only works with Paper connected:

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

If it doesn't work

  • VS Code asks you to trust a server the first time it starts. Accept it, or the tools stay hidden.
  • code --add-mcp writes to your user profile, so the server works in every workspace.
  • Use MCP: List Servers → Show Output to see startup errors.