Mmcp.market

Paperless-ngx MCP server

by cubinet-code·io.github.cubinet-code/paperless-ngx-mcp·v3.2.0
No reviews yet

Full Paperless-ngx API for AI assistants: search, tag, edit and upload documents, workflows and more

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

5 stars106 downloads/wk

Reviews

Write one

Nobody has reviewed Paperless-ngx yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Paperless-ngx tools

No tool declarations could be read from the package source. They show once the server is installed.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

no findings
  • Code scan71 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 0 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the Paperless-ngx repository's README, as published. We do not edit it. Read it on GitHub

paperless-ngx-mcp

A Model Context Protocol server for Paperless-NGX. Exposes the full Paperless-NGX REST API to AI assistants — documents, tags, correspondents, document types, custom fields, storage paths, saved views, share links and bundles, workflows, mail accounts and rules, document versions, notes, trash, and tasks.

Why this one?

  • Complete, and it stays that way. A CI test checks every endpoint in Paperless's /api/schema/ against the tools here and fails when upstream adds one that is neither wrapped nor deliberately skipped.
  • Tested against real Paperless. The end-to-end suite runs the tools against a live Paperless-ngx 3.2.1 container, not mocks.
  • Asks before it breaks things. Every delete tool, emptytrash, mergedocumentsasversions and bulk delete require confirm: true; bulk edits across "all matching documents" refuse filters Paperless would silently ignore; and the triageinbox prompt proposes changes and waits for your go-ahead before writing anything.
  • Easy to allowlist. Verb-first tool names (list, get, delete_*, …) group into one permission wildcard each.
  • Install it your way: npx, a Docker image, a one-click Claude Desktop extension, or the official MCP Registry.

Compatibility

Targets Paperless-ngx 3.2 (tested against 3.2.1). Older Paperless versions are not supported — use paperless-ngx-mcp@3.1.1 for Paperless 2.x. The package major version tracks the Paperless-ngx major it targets; there are no 1.x or 2.x releases.

Quick Start

The server is published to npm as paperless-ngx-mcp. You can run it with npx — no clone or build required.

Claude Code

claude mcp add paperless --scope user \
  --env PAPERLESS_URL=https://your-paperless-instance \
  --env PAPERLESS_API_KEY=your-api-token \
  -- npx -y paperless-ngx-mcp

Drop --scope user to install for the current project only. See claude mcp add --help for more options.

Codex CLI

codex mcp add paperless \
  --env PAPERLESS_URL=https://your-paperless-instance \
  --env PAPERLESS_API_KEY=your-api-token \
  -- npx -y paperless-ngx-mcp

This writes the entry to ~/.codex/config.toml.

Claude Desktop (extension)

Download paperless-ngx-mcp.mcpb from the latest release and double-click it, or install it from Settings → Extensions. Claude Desktop asks for your Paperless URL and API token.

Claude Desktop, Cursor, Cline, and other MCP clients

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

Runs npx -y paperless-ngx-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add paperless-ngx-mcp -- npx -y paperless-ngx-mcp
Add to Cursor

Paperless-ngx: common questions

Is Paperless-ngx MCP server safe?
Mostly: it is graded B (83/100). Read the Paperless-ngx safety report
How do I install Paperless-ngx?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does Paperless-ngx need an API key?
Yes. The registry entry asks for PAPERLESS_API_KEY.
Is Paperless-ngx maintained?
The last commit was in the last day (2026-09-23). The latest release is v3.2.0.
What can I use instead of Paperless-ngx?
Servers from other publishers that do the same job: Documentation MCP server, reMarkable MCP Server and Stackexchange MCP server. Compare all Paperless-ngx alternatives.

Alternatives to Paperless-ngx

Same job from other publishers: the closest match first, then the best rated.

All Paperless-ngx alternatives →
  • Documentation
    Local-first document management and semantic search for AI coding agents
    A
  • reMarkable MCP Server
    Read, render, search, and manage reMarkable documents through MCP
    B
  • Stackexchange
    Search Stack Exchange questions, fetch Q&A threads as markdown, look up tag FAQs and user profiles.
    A
  • Free Search
    No-API-key web search, page fetching and document reading across many engines. Local-first.
    B
Paperless-ngx vs DocumentationPaperless-ngx vs reMarkable MCP ServerPaperless-ngx vs Stackexchange

More from cubinet-code →