Paper MCP Server

MCP server that connects to Paper's WebSocket API for canvas node operations.

Setup

1. Install dependencies:

2. Build the project:

Configuration

1. Copy env.example to .env:

2. Edit .env and fill in your values (or set environment variables directly):

Getting Your Cookies

1. Open Paper in your browser (https://app.paper.design)

2. Open Developer Tools (F12)

3. Go to Application → Cookies → https://app.paper.design

4. Copy the values for these cookies:

   • paper-preauth-user-info

   • D7pPzj4phQRAjBC01

   • ph_phc_dYB3kPJF9dv2vFhHjPmuuU5D7yQVDFtMYJQpVEXu9Ku_posthog

5. Format them as: cookie1=value1; cookie2=value2; cookie3=value3

Connecting to Cursor

Option 1: Using Cursor Settings (Recommended)

1. Open Cursor Settings (Ctrl+, or Cmd+,)

2. Search for "MCP" or navigate to Features → Model Context Protocol

3. Click "Add MCP Server" or "Edit Config"

4. Add the following configuration:

On Windows:

On macOS/Linux:

5. Replace the paths and cookie values with your actual values

6. Restart Cursor

Option 2: Using MCP Config File

1. Find your Cursor MCP config file:

   • Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Add the server configuration (same JSON as above)

3. Restart Cursor

Option 3: Using dotenv (Alternative)

If you prefer using a .env file:

1. Install dotenv-cli: npm install -g dotenv-cli

2. Update the Cursor config to use:

Usage

Once connected to Cursor, you can use the Paper tools in your conversations:

• "List my Paper documents"

• "Show me all nodes on the canvas"

• "Get details of node XYZ"

• "Create a new rectangle node at position (100, 200)"

• "Update node ABC with new properties"

• "Delete node DEF"

The server communicates via stdio using MCP JSON-RPC protocol.

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

• update_node: Update node properties

• delete_node: Delete a node