Paperless-ngx MCP Server

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

Local serverstdio

What is the Paperless-ngx MCP Server?

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

Packages and local setup

The published npm package is mcp-paperless-ngx, version 0.1.1. Its declared MCP transport is stdio.

The package declares PAPERLESS_URL (required): Base URL of the Paperless-ngx instance; PAPERLESS_TOKEN (required): 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.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
PAPERLESS_URLBase URL of the Paperless-ngx instanceYes
PAPERLESS_TOKENPaperless-ngx API tokenYes
PAPERLESS_PUBLIC_URLURL used when building links, if the instance is reachable under a different name from outsideOptional
PAPERLESS_TOOLSETSComma-separated toolsets, or allOptional
PAPERLESS_READ_ONLYExpose only tools that cannot change anythingOptional
PAPERLESS_HEADERSExtra request headers; needed behind forward-auth proxies such as AuthentikOptional
PAPERLESS_DOWNLOAD_DIRWhere downloaded files are writtenOptional
PAPERLESS_MAX_PAGE_SIZEHard ceiling on list page sizesOptional
PAPERLESS_TIMEOUT_MSRequest timeout in millisecondsOptional
PAPERLESS_API_VERSIONREST API version sent in the Accept headerOptional