Paperless MCP
io.github.pvliesdonk
Paperless-NGX over MCP: search, read, upload and tag documents; manage correspondents and types.
{ "mcpServers": { "io.github.pvliesdonk-paperless-mcp": { "command": "uvx", "args": [ "pvliesdonk-paperless-mcp==3.0.0" ], "env": { "PAPERLESS_MCP_KV_STORE_URL": "<value>", "PAPERLESS_MCP_TOOLS_ALLOW": "<value>", "PAPERLESS_MCP_TOOLS_DENY": "<value>", "PAPERLESS_MCP_SERVER_NAME": "<value>", "PAPERLESS_MCP_INSTANCE_DESCRIPTION": "<value>", "PAPERLESS_MCP_INSTRUCTIONS_EXTRA": "<value>", "PAPERLESS_MCP_INSTRUCTIONS": "<value>", "PAPERLESS_MCP_LOG_LEVEL": "<value>", "PAPERLESS_MCP_LOG_FORMAT": "<value>", "PAPERLESS_MCP_PAPERLESS_URL": "<value>", "PAPERLESS_MCP_API_TOKEN": "<secret>", "PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS": "<value>", "PAPERLESS_MCP_HTTP_RETRIES": "<value>", "PAPERLESS_MCP_DEFAULT_PAGE_SIZE": "<value>", "PAPERLESS_MCP_PAPERLESS_PUBLIC_URL": "<value>", "PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S": "<value>", "PAPERLESS_MCP_TRANSFER_TTL_MAX_S": "<value>", "PAPERLESS_MCP_TRANSFER_GRACE_TTL_S": "<value>", "PAPERLESS_MCP_TRANSFER_LEASE_S": "<value>", "PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<value>" } } }}.cursor/mcp.jsonMCP server
- Transport
- stdio
- Status
- Local
Power your agent
Add this server
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
Local command
uvx pvliesdonk-paperless-mcp==3.0.0Credentials from the publisher
- PAPERLESS_MCP_KV_STORE_URL — Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `mongodb://` each need their matching extra. When unset, defaults to `file:///data/state` (the volume family Docker images mount), or to `memory://` (with a warning) on a host where that directory is not usable.
- PAPERLESS_MCP_TOOLS_ALLOW — Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_deny`. Takes effect through `apply_tool_visibility`.
- PAPERLESS_MCP_TOOLS_DENY — Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effect through `apply_tool_visibility`.
- PAPERLESS_MCP_SERVER_NAME — Rename this server instance; defaults to the project name.
- PAPERLESS_MCP_INSTANCE_DESCRIPTION — Concise routing context that distinguishes this deployment's material or responsibility.
- PAPERLESS_MCP_INSTRUCTIONS_EXTRA — Deployment-specific behavioral policy added to the generated MCP instructions.
- PAPERLESS_MCP_INSTRUCTIONS — Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
- PAPERLESS_MCP_LOG_LEVEL — Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one major version and logs a deprecation warning.
- PAPERLESS_MCP_LOG_FORMAT — Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere else, so a container or journald gets JSON with no configuration.
- PAPERLESS_MCP_PAPERLESS_URL — Base URL of the Paperless-NGX REST API, without a trailing slash. The server refuses to start without it.
- PAPERLESS_MCP_API_TOKEN — Paperless service-account token used for outbound API requests. The server refuses to start without it.
- PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS — Per-request HTTP timeout in seconds.
- PAPERLESS_MCP_HTTP_RETRIES — Retries for idempotent requests after network errors or 5xx responses.
- PAPERLESS_MCP_DEFAULT_PAGE_SIZE — Default page size for list tools, from 1 through 100.
- PAPERLESS_MCP_PAPERLESS_PUBLIC_URL — Public Paperless UI URL for user-visible links; defaults to PAPERLESS_URL.
- PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S — Link lifetime in seconds when the caller requests no explicit TTL.
- PAPERLESS_MCP_TRANSFER_TTL_MAX_S — Ceiling in seconds a caller-requested link TTL is clamped to.
- PAPERLESS_MCP_TRANSFER_GRACE_TTL_S — Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it.
- PAPERLESS_MCP_TRANSFER_LEASE_S — Crashed-handler reclaim window in seconds for an in-flight reservation.
- PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES — Maximum size in bytes of a single upload.
Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
shClaude Code
PAPERLESS_MCP_KV_STORE_URL=<value> PAPERLESS_MCP_TOOLS_ALLOW=<value> PAPERLESS_MCP_TOOLS_DENY=<value> PAPERLESS_MCP_SERVER_NAME=<value> PAPERLESS_MCP_INSTANCE_DESCRIPTION=<value> PAPERLESS_MCP_INSTRUCTIONS_EXTRA=<value> PAPERLESS_MCP_INSTRUCTIONS=<value> PAPERLESS_MCP_LOG_LEVEL=<value> PAPERLESS_MCP_LOG_FORMAT=<value> PAPERLESS_MCP_PAPERLESS_URL=<value> PAPERLESS_MCP_API_TOKEN=<secret> PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS=<value> PAPERLESS_MCP_HTTP_RETRIES=<value> PAPERLESS_MCP_DEFAULT_PAGE_SIZE=<value> PAPERLESS_MCP_PAPERLESS_PUBLIC_URL=<value> PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S=<value> PAPERLESS_MCP_TRANSFER_TTL_MAX_S=<value> PAPERLESS_MCP_TRANSFER_GRACE_TTL_S=<value> PAPERLESS_MCP_TRANSFER_LEASE_S=<value> PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES=<value> claude mcp add io.github.pvliesdonk-paperless-mcp -- uvx pvliesdonk-paperless-mcp==3.0.0Run in a terminal.
jsonClaude Desktop
{ "mcpServers": { "io.github.pvliesdonk-paperless-mcp": { "command": "uvx", "args": [ "pvliesdonk-paperless-mcp==3.0.0" ], "env": { "PAPERLESS_MCP_KV_STORE_URL": "<value>", "PAPERLESS_MCP_TOOLS_ALLOW": "<value>", "PAPERLESS_MCP_TOOLS_DENY": "<value>", "PAPERLESS_MCP_SERVER_NAME": "<value>", "PAPERLESS_MCP_INSTANCE_DESCRIPTION": "<value>", "PAPERLESS_MCP_INSTRUCTIONS_EXTRA": "<value>", "PAPERLESS_MCP_INSTRUCTIONS": "<value>", "PAPERLESS_MCP_LOG_LEVEL": "<value>", "PAPERLESS_MCP_LOG_FORMAT": "<value>", "PAPERLESS_MCP_PAPERLESS_URL": "<value>", "PAPERLESS_MCP_API_TOKEN": "<secret>", "PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS": "<value>", "PAPERLESS_MCP_HTTP_RETRIES": "<value>", "PAPERLESS_MCP_DEFAULT_PAGE_SIZE": "<value>", "PAPERLESS_MCP_PAPERLESS_PUBLIC_URL": "<value>", "PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S": "<value>", "PAPERLESS_MCP_TRANSFER_TTL_MAX_S": "<value>", "PAPERLESS_MCP_TRANSFER_GRACE_TTL_S": "<value>", "PAPERLESS_MCP_TRANSFER_LEASE_S": "<value>", "PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<value>" } } }}claude_desktop_config.json
Local · pypiPublisher installStep-by-step: add this in Claude
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
Host a copy with our keys and logs.
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchServer facts
Local- Transport
- stdio
- Version
- 3.0.0
- API key
- PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_SERVER_NAME, PAPERLESS_MCP_INSTANCE_DESCRIPTION, PAPERLESS_MCP_INSTRUCTIONS_EXTRA, PAPERLESS_MCP_INSTRUCTIONS, PAPERLESS_MCP_LOG_LEVEL, PAPERLESS_MCP_LOG_FORMAT, PAPERLESS_MCP_PAPERLESS_URL, PAPERLESS_MCP_API_TOKEN, PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS, PAPERLESS_MCP_HTTP_RETRIES, PAPERLESS_MCP_DEFAULT_PAGE_SIZE, PAPERLESS_MCP_PAPERLESS_PUBLIC_URL, PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S, PAPERLESS_MCP_TRANSFER_TTL_MAX_S, PAPERLESS_MCP_TRANSFER_GRACE_TTL_S, PAPERLESS_MCP_TRANSFER_LEASE_S, PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES, PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN, PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET, PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY, PAPERLESS_MCP_OIDC_VERIFY_ACCESS_TOKEN, PAPERLESS_MCP_APP_DOMAIN, PAPERLESS_MCP_AUTH_MODE, PAPERLESS_MCP_BEARER_TOKENS_FILE, PAPERLESS_MCP_BEARER_DEFAULT_SUBJECT, PAPERLESS_MCP_HTTP_PATH, PAPERLESS_MCP_HEALTH_DETAIL, PUID, PGID
- Last checked
- 2026-10-26
- Stars
- —
- Tools
- —
- Uptime
- —
Tools
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Questions
How do I install Paperless MCP?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Paperless MCP need an API key?
The publisher lists these environment variables: PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_SERVER_NAME, PAPERLESS_MCP_INSTANCE_DESCRIPTION, PAPERLESS_MCP_INSTRUCTIONS_EXTRA, PAPERLESS_MCP_INSTRUCTIONS, PAPERLESS_MCP_LOG_LEVEL, PAPERLESS_MCP_LOG_FORMAT, PAPERLESS_MCP_PAPERLESS_URL, PAPERLESS_MCP_API_TOKEN, PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS, PAPERLESS_MCP_HTTP_RETRIES, PAPERLESS_MCP_DEFAULT_PAGE_SIZE, PAPERLESS_MCP_PAPERLESS_PUBLIC_URL, PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S, PAPERLESS_MCP_TRANSFER_TTL_MAX_S, PAPERLESS_MCP_TRANSFER_GRACE_TTL_S, PAPERLESS_MCP_TRANSFER_LEASE_S, PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES, PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_TOKEN, PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CLIENT_SECRET, PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY, PAPERLESS_MCP_OIDC_VERIFY_ACCESS_TOKEN, PAPERLESS_MCP_APP_DOMAIN, PAPERLESS_MCP_AUTH_MODE, PAPERLESS_MCP_BEARER_TOKENS_FILE, PAPERLESS_MCP_BEARER_DEFAULT_SUBJECT, PAPERLESS_MCP_HTTP_PATH, PAPERLESS_MCP_HEALTH_DETAIL, PUID, PGID.
What transport does Paperless MCP use?
Paperless MCP runs locally over stdio.
When was Paperless MCP last checked?
Last checked 2026-10-26. Paperless-NGX over MCP: search, read, upload and tag documents; manage correspondents and types.
From the publisher
Documentation
README is not crawled yet. Open the repository