Skip to content

Connect Paper to Codex

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

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

    Add it from the terminal

    Saves the server to ~/.codex/config.toml, so it works in every project.

    Terminal
    codex mcp add paper -- ~/.paper/bin/paper mcp

    Or edit the 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
    • 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
    codex mcp list

    In a Codex session, run /mcp to see connected servers and their tools.

  3. Step 3: Try a first request

    Ask Codex something that only works with Paper connected:

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

If it doesn't work

  • Codex reads ~/.codex/config.toml. A project .codex/config.toml is only read in projects you have trusted.
  • Codex doesn't expand ~ or environment variables in command. Use a full path in the config file.
  • Servers that need a sign-in: run codex mcp login <name>.