Paperless-ngx MCP Server

io.github.tobee89/mcp-paperless-ngx

Repository Registry

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.

transport: stdio

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

Environment / auth

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

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

{
  "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

io.github.tobs-code/cozo-memory

Maintained

Local-first memory system for AI agents with hybrid search and graph reasoning

HTML

Apache-2.0

View repository →

io.github.toby/mirror-mcp

Abandoned

Enable LLMs to reflect on themselves through recursive questioning and MCP sampling.

TypeScript

MIT

View repository →

ToFlow

Maintained

AI sales automation for toflow.ai — prospect, enrich, sequence across email, LinkedIn, WhatsApp.

MIT

View repository →

Toggl 2.0

Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.

Experimental Legal Grounding

Experimental GDPR grounding: rules, preconditions, exceptions, exact quotes, and citation checks.

io.github.toki0413/saturday-materials

Active

Materials computing tools for AI agents: structures, engines, phonons, EOS, NEB, sampling, lineage.

JavaScript

MIT

View repository →