PluginBench
MCP Server
Maintained
MIT

Paperless-ngx MCP Server

io.github.tobee89/mcp-paperless-ngx

RepositoryRegistry
How to choose

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.

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
JSON config
{
  "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.

1
TypeScript
MIT
View repository →
MNMnemoscope logo

Mnemoscope

Maintained

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

1
TypeScript
Apache-2.0
View repository →

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

4
Python
View repository →

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

1
HTML
Apache-2.0
View repository →

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

15
TypeScript
MIT
View repository →