# Paper MCP Server
MCP server that connects to Paper's WebSocket API for canvas node operations.
## Setup
1. Install dependencies:
```bash
npm install
```
2. Build the project:
```bash
npm run build
```
## Configuration
1. Copy `env.example` to `.env`:
```bash
cp env.example .env
```
2. Edit `.env` and fill in your values (or set environment variables directly):
```bash
# Required: Full cookie string from Paper website
# Get this from your browser's developer tools -> Application -> Cookies -> paper.design
# Should include all three cookies: paper-preauth-user-info, D7pPzj4phQRAjBC01, and ph_phc_...
PAPER_COOKIES=paper-preauth-user-info=...; D7pPzj4phQRAjBC01=...; ph_phc_dYB3kPJF9dv2vFhHjPmuuU5D7yQVDFtMYJQpVEXu9Ku_posthog=...
# Optional: Document ID to connect to (defaults to example ID)
# You can get document IDs from the list_user_documents tool or from Paper URLs
PAPER_DOCUMENT_ID=01KBWAZRVPXZZ1Y0EZ5FDT7ZYW
# Optional: Enable debug logging for WebSocket messages
DEBUG=false
```
### 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:**
```json
{
"mcpServers": {
"paper": {
"command": "node",
"args": ["C:\\Users\\grim\\paper-mcp\\dist\\index.js"],
"env": {
"PAPER_COOKIES": "your-cookie-string-here",
"PAPER_DOCUMENT_ID": "01KBWAZRVPXZZ1Y0EZ5FDT7ZYW",
"DEBUG": "false"
}
}
}
}
```
**On macOS/Linux:**
```json
{
"mcpServers": {
"paper": {
"command": "node",
"args": ["/path/to/paper-mcp/dist/index.js"],
"env": {
"PAPER_COOKIES": "your-cookie-string-here",
"PAPER_DOCUMENT_ID": "01KBWAZRVPXZZ1Y0EZ5FDT7ZYW",
"DEBUG": "false"
}
}
}
}
```
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:
```json
{
"mcpServers": {
"paper": {
"command": "dotenv",
"args": ["-e", ".env", "--", "node", "dist/index.js"],
"cwd": "C:\\Users\\grim\\paper-mcp"
}
}
}
```
## 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
