Connect Cursor to PaperOffice (MCP)

Cursor does not use a connector dialog like Claude — the connection is configured directly in the mcp.json file. The user token goes into the Authorization header.

Get your user token ready

In PaperOffice, open PaperOffice Account → API and copy your user token (starts with po_ut_ or po_gt_). Secret keys (po_sk_) are blocked for MCP.

Open Cursor Settings

In Cursor, choose File → Cursor Settings (also under File → Preferences → Cursor Settings, shortcut Ctrl+,). Not the VS Code settings.

Open Customize and MCPs

Go to Customize on the left and select the MCPs filter at the top. Existing servers appear under “Connected”. Create a new one via + New or Add a Custom MCP Server.

Edit and save mcp.json

Open the file ~/.cursor/mcp.json (source “User”), insert the paperoffice block, and save. The bearer is the user token from the first step.

{
  "mcpServers": {
    "paperoffice": {
      "url": "https://mcp.paperoffice.ai/cursor",
      "headers": {
        "Authorization": "Bearer po_ut_YOUR_TOKEN"
      }
    }
  }
}

Verify the connection

After saving, paperoffice appears under “Connected” with a green dot and the PaperOffice tools. If the list stays empty, choose Reload in the dialog.

Ask in the Cursor chat

PaperOffice is connected. Ask the agent, for example:

List the workspaces in my PaperOffice account and show the most recent documents.