Paper

Provides a Paper MCP Server to manage Paper documents and canvas nodes via MCP clients.

javascript

2

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ripgrim-paper-mcp": {
      "command": "node",
      "args": [
        "C:\\Users\\grim\\paper-mcp\\dist/index.js"
      ],
      "env": {
        "DEBUG": "false",
        "PAPER_COOKIES": "your-cookie-string-here",
        "PAPER_DOCUMENT_ID": "01KBWAZRVPXZZ1Y0EZ5FDT7ZYW"
      }
    }
  }
}

You can run Paper MCP Server locally to connect with Paper’s canvas so you can manage nodes and documents through your MCP client. This server bridges the Paper API with an interface you can query from conversations, enabling commands like listing documents, viewing canvas nodes, and creating or updating shapes in your documents.

How to use

You connect to the Paper MCP Server from your MCP client by starting a local stdio server that runs the Paper MCP code and then pointing your client to that server. Once connected, you can run commands through your client to list documents, inspect nodes on the canvas, retrieve node details, and perform create, update, or delete actions on nodes.

How to install

Prerequisites: you need Node.js and npm installed on your system to run the MCP server and its tooling.

Install dependencies for the Paper MCP project.

npm install
```} ,{

Build the project to generate the runtime artifacts.

npm run build
```"}]},{

Configure your environment and start an MCP connection in your MCP client. You will provide cookie data from Paper and optionally a document ID to connect to a specific document.

Configuration and security

Prepare the required environment variables before starting the MCP server. You will collect cookies from Paper and choose a document to connect to if needed.

PAPER_COOKIES=paper-preauth-user-info=...; D7pPzj4phQRAjBC01=...; ph_phc_dYB3kPJF9dv2vFhHjPmuuU5D7yQVDFtMYJQpVEXu9Ku_posthog=...
PAPER_DOCUMENT_ID=01KBWAZRVPXZZ1Y0EZ5FDT7ZYW
DEBUG=false
```"}]},{

Keeping your cookies secure is important. Do not share the cookie string publicly and rotate cookies if you suspect they may be exposed.

Examples of how to connect using MCP clients

You can connect by configuring an MCP server entry in your MCP client. The project provides local stdio configurations that run the Paper MCP runtime and expose the necessary commands through standard input/output.

Tools

This server exposes a set of MCP endpoints to manage Paper documents and canvas nodes.

Troubleshooting and notes

If you cannot connect, verify your environment variables are set correctly and that the dist/index.js file path matches where you built your project. Ensure you restarted your MCP client after updating configuration.

Available tools

list_user_documents

Get user's recent Paper documents

list_nodes

List all nodes on the canvas

get_node

Get details of a specific node

create_node

Create a new node on the canvas or document

update_node

Update properties of an existing node

delete_node

Delete a node from the canvas or document