Paperless-ngx MCP Server

io.github.cubinet-code/paperless-ngx-mcp

Repository Registry

What is the Paperless-ngx MCP server?

Full Paperless-ngx API for AI assistants: search, tag, edit and upload documents, workflows and more

How to install Paperless-ngx

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PAPERLESS_URL
required
Base URL of your Paperless-ngx instance, e.g. https://paperless.example.com
PAPERLESS_API_KEY
required
secret
Paperless-ngx API token (My Profile → generate token)
PAPERLESS_PUBLIC_URL
Public URL used for browser links to documents. Defaults to PAPERLESS_URL.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "paperless-ngx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "paperless-ngx-mcp"
      ],
      "env": {
        "PAPERLESS_URL": "<YOUR_PAPERLESS_URL>",
        "PAPERLESS_API_KEY": "<YOUR_PAPERLESS_API_KEY>",
        "PAPERLESS_PUBLIC_URL": "<YOUR_PAPERLESS_PUBLIC_URL>"
      }
    }
  }
}