Paperless-ngx MCP Server
io.github.tobee89/mcp-paperless-ngx
What this kind of tool is for
- Create, search, or update items in a notes, docs, or tasks service from your agent.
- Turn a meeting transcript or a long document into a structured summary.
- Keep a daily log or standup digest without leaving the terminal.
How to compare servers like this
- Service scope:
- Confirm the tool covers the exact service and surfaces (pages, tasks, calendars) you need.
- Auth model:
- See whether it uses an API token you control and what permissions that token grants.
- Read vs write:
- Start with read-only workflows; give write access only after the first results look right.
- Maintenance signal:
- For anything tied to a third-party API, prefer tools that track that API's changes.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the Paperless-ngx MCP server?
MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.
How to install Paperless-ngx
Copy-paste configuration for popular MCP clients.
PAPERLESS_URLrequiredBase URL of the Paperless-ngx instance
PAPERLESS_TOKENrequiredsecretPaperless-ngx API token
PAPERLESS_PUBLIC_URLURL used when building links, if the instance is reachable under a different name from outside
PAPERLESS_TOOLSETSComma-separated toolsets, or all
PAPERLESS_READ_ONLYExpose only tools that cannot change anything
PAPERLESS_HEADERSExtra request headers; needed behind forward-auth proxies such as Authentik
PAPERLESS_DOWNLOAD_DIRWhere downloaded files are written
PAPERLESS_MAX_PAGE_SIZEHard ceiling on list page sizes
PAPERLESS_TIMEOUT_MSRequest timeout in milliseconds
PAPERLESS_API_VERSIONREST API version sent in the Accept header
{
"mcpServers": {
"mcp-paperless-ngx": {
"command": "npx",
"args": [
"-y",
"mcp-paperless-ngx"
],
"env": {
"PAPERLESS_URL": "<YOUR_PAPERLESS_URL>",
"PAPERLESS_TOKEN": "<YOUR_PAPERLESS_TOKEN>",
"PAPERLESS_PUBLIC_URL": "<YOUR_PAPERLESS_PUBLIC_URL>",
"PAPERLESS_TOOLSETS": "<YOUR_PAPERLESS_TOOLSETS>",
"PAPERLESS_READ_ONLY": "<YOUR_PAPERLESS_READ_ONLY>",
"PAPERLESS_HEADERS": "<YOUR_PAPERLESS_HEADERS>",
"PAPERLESS_DOWNLOAD_DIR": "<YOUR_PAPERLESS_DOWNLOAD_DIR>",
"PAPERLESS_MAX_PAGE_SIZE": "<YOUR_PAPERLESS_MAX_PAGE_SIZE>",
"PAPERLESS_TIMEOUT_MS": "<YOUR_PAPERLESS_TIMEOUT_MS>",
"PAPERLESS_API_VERSION": "<YOUR_PAPERLESS_API_VERSION>"
}
}
}
}Related MCP servers
Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.

Bootstrap Linear projects from natural language — milestones, epics, issues, and dependencies.

Mnemoscope
Predict context rot, sign every agent write, tier reads. Markdown-native, 100% local.

Your AI agents' home directory — privacy-first MCP server for portable AI identity.

io.github.tobs-code/cozo-memory
Local-first memory system for AI agents with hybrid search and graph reasoning

io.github.toby/mirror-mcp
Enable LLMs to reflect on themselves through recursive questioning and MCP sampling.