Home › File Systems › Paperless-ngx

Paperless-ngx

MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.

TypeScript Local macOSWindowsLinux

★ 2 stars Last pushed 2026-08-21 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.1.1)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-paperless-ngx": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "PAPERLESS_URL": "<YOUR_VALUE>",
        "PAPERLESS_TOKEN": "<YOUR_VALUE>",
        "PAPERLESS_PUBLIC_URL": "<YOUR_VALUE>",
        "PAPERLESS_TOOLSETS": "<YOUR_VALUE>",
        "PAPERLESS_READ_ONLY": "<YOUR_VALUE>",
        "PAPERLESS_HEADERS": "<YOUR_VALUE>",
        "PAPERLESS_DOWNLOAD_DIR": "<YOUR_VALUE>",
        "PAPERLESS_MAX_PAGE_SIZE": "<YOUR_VALUE>",
        "PAPERLESS_TIMEOUT_MS": "<YOUR_VALUE>",
        "PAPERLESS_API_VERSION": "<YOUR_VALUE>"
      }
    }
  }
}

PAPERLESS_URL required — Base URL of the Paperless-ngx instance
PAPERLESS_TOKEN required secret — Paperless-ngx API token
PAPERLESS_PUBLIC_URL — URL used when building links, if the instance is reachable under a different name from outside
PAPERLESS_TOOLSETS — Comma-separated toolsets, or all
PAPERLESS_READ_ONLY — Expose only tools that cannot change anything
PAPERLESS_HEADERS — Extra request headers; needed behind forward-auth proxies such as Authentik
PAPERLESS_DOWNLOAD_DIR — Where downloaded files are written
PAPERLESS_MAX_PAGE_SIZE — Hard ceiling on list page sizes
PAPERLESS_TIMEOUT_MS — Request timeout in milliseconds
PAPERLESS_API_VERSION — REST API version sent in the Accept header