LocalFree server, account needed

Paperless-ngx MCP server

tobee89/mcp-paperless-ngx

Paperless-ngx 3.x document archive: search and read documents, file them, bulk-edit, manage tags, correspondents, custom fields, workflows and share links. All 92 documented REST endpoints are either exposed or explicitly excluded with a reason, enforced by a test. OCR text sits behind its own paginated tool so a search cannot flood the context; toolsets and --read-only limit the exposed surface.

2 GitHub stars1 forks2,576 npm downloads / month

Install Paperless-ngx in Claude Code

Claude Code
claude mcp add paperless-ngx -e PAPERLESS_URL=... -e PAPERLESS_TOKEN=... -- npx -y mcp-paperless-ngx
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "paperless-ngx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-paperless-ngx"
      ],
      "env": {
        "PAPERLESS_URL": "...",
        "PAPERLESS_TOKEN": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Paperless-ngx MCP server do?

Paperless-ngx 3.x document archive: search and read documents, file them, bulk-edit, manage tags, correspondents, custom fields, workflows and share links. All 92 documented REST endpoints are either exposed or explicitly excluded with a reason, enforced by a test. OCR text sits behind its own paginated tool so a search cannot flood the context; toolsets and --read-only limit the exposed surface.

Is the Paperless-ngx MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Paperless-ngx run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Paperless-ngx to Claude Code?

Run: claude mcp add paperless-ngx -e PAPERLESS_URL=... -e PAPERLESS_TOKEN=... -- npx -y mcp-paperless-ngx

More file systems & storage MCP servers

View all