Paperless MCP
Paperless-NGX over MCP: search, read, upload and tag documents; manage correspondents and types.
MCP server · by pvliesdonk
About
Paperless MCP is an MCP server published by pvliesdonk. Marketplaces we read that list it: 1 (Official MCP Registry). We first saw it on 2026-10-11 and have recorded no change since. As of our marketplace pass on 2026-10-13.
What it asks for
- Runs on your machine
- Secrets: 4
- Settings: 39
Requires: PAPERLESS_MCP_API_TOKEN (secret), PAPERLESS_MCP_BEARER_TOKEN (secret), PAPERLESS_MCP_OIDC_CLIENT_SECRET (secret), PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY (secret)
What it declares, asks for and runs, in full
Only install plugins from developers you trust. We list what marketplaces publish and do not test plugins.
Package
PyPI pvliesdonk-paperless-mcp (pvliesdonk-paperless-mcp on PyPI)
- PyPI downloads/week: 91 (2026-10-13)
- PyPI downloads/month: 1 068 (2026-10-13)
- Latest version on PyPI: 3.0.0, published 2026-09-21
No known vulnerabilities in OSV for 3.0.0 (checked 2026-10-13)
PyPI facts come from pypi.org, PyPI downloads from pypistats.org. Each figure is the registry's own and is never added to another. A registry that publishes no figure shows none: no number is not zero. Vulnerability records come from OSV.dev (CC BY 4.0) and concern the declared version only; a listing that declares no version gets no answer. We do not scan code.
Works with
- Claude Code
- Codex
- Cursor
- VS Code
- Copilot CLI
From the marketplaces that list it and the MCP transport it declares, as each client documents them. We do not test plugins.
Connect
Commands and configs built only from what its marketplaces declare. We do not run them for you and do not test plugins.
As a local MCP server: PyPI package
Built from what Official MCP Registry declares.
claude mcp add --env "PAPERLESS_MCP_API_TOKEN=<YOUR_PAPERLESS_MCP_API_TOKEN>" --env "PAPERLESS_MCP_BEARER_TOKEN=<YOUR_PAPERLESS_MCP_BEARER_TOKEN>" --env "PAPERLESS_MCP_OIDC_CLIENT_SECRET=<YOUR_PAPERLESS_MCP_OIDC_CLIENT_SECRET>" --env "PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY=<YOUR_PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY>" --transport stdio paperless-mcp -- uvx pvliesdonk-paperless-mcp[mcp_servers.paperless-mcp]
command = "uvx"
args = ["pvliesdonk-paperless-mcp"]
[mcp_servers.paperless-mcp.env]
PAPERLESS_MCP_API_TOKEN = "<YOUR_PAPERLESS_MCP_API_TOKEN>"
PAPERLESS_MCP_BEARER_TOKEN = "<YOUR_PAPERLESS_MCP_BEARER_TOKEN>"
PAPERLESS_MCP_OIDC_CLIENT_SECRET = "<YOUR_PAPERLESS_MCP_OIDC_CLIENT_SECRET>"
PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY = "<YOUR_PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY>"{
"mcpServers": {
"paperless-mcp": {
"command": "uvx",
"args": [
"pvliesdonk-paperless-mcp"
],
"env": {
"PAPERLESS_MCP_API_TOKEN": "<YOUR_PAPERLESS_MCP_API_TOKEN>",
"PAPERLESS_MCP_BEARER_TOKEN": "<YOUR_PAPERLESS_MCP_BEARER_TOKEN>",
"PAPERLESS_MCP_OIDC_CLIENT_SECRET": "<YOUR_PAPERLESS_MCP_OIDC_CLIENT_SECRET>",
"PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY": "<YOUR_PAPERLESS_MCP_OIDC_JWT_SIGNING_KEY>"
}
}
}
}Replace the values in angle brackets with your own. We show the names of the settings, never values.
Optional settings it also lists: PAPERLESS_MCP_APP_DOMAIN, PAPERLESS_MCP_AUTH_MODE, PAPERLESS_MCP_BASE_URL, PAPERLESS_MCP_BEARER_DEFAULT_SUBJECT, PAPERLESS_MCP_BEARER_TOKENS_FILE, PAPERLESS_MCP_DEFAULT_PAGE_SIZE, PAPERLESS_MCP_HEALTH_DETAIL, PAPERLESS_MCP_HTTP_PATH, PAPERLESS_MCP_HTTP_RETRIES, PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS, PAPERLESS_MCP_INSTANCE_DESCRIPTION, PAPERLESS_MCP_INSTRUCTIONS, PAPERLESS_MCP_INSTRUCTIONS_EXTRA, PAPERLESS_MCP_KV_STORE_URL, PAPERLESS_MCP_LOG_FORMAT, PAPERLESS_MCP_LOG_LEVEL, PAPERLESS_MCP_OIDC_ADVERTISED_SCOPES, PAPERLESS_MCP_OIDC_AUDIENCE, PAPERLESS_MCP_OIDC_CLIENT_ID, PAPERLESS_MCP_OIDC_CONFIG_URL, PAPERLESS_MCP_OIDC_REQUIRED_SCOPES, PAPERLESS_MCP_OIDC_VERIFY_ACCESS_TOKEN, PAPERLESS_MCP_PAPERLESS_PUBLIC_URL, PAPERLESS_MCP_PAPERLESS_URL, PAPERLESS_MCP_SERVER_NAME, PAPERLESS_MCP_SHUTDOWN_GRACE_S, PAPERLESS_MCP_TOOLS_ALLOW, PAPERLESS_MCP_TOOLS_DENY, PAPERLESS_MCP_TRANSFER_GRACE_TTL_S, PAPERLESS_MCP_TRANSFER_LEASE_S, PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES, PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S, PAPERLESS_MCP_TRANSFER_TTL_MAX_S, PGID, PUID.
Where it is published
| Marketplace | Status | Version | Figures | Verified | First seen |
|---|---|---|---|---|---|
| Official MCP Registry (Open the registry record) | Listed | 3.0.0 | Downloads/month (PyPI): 1 068 Downloads/week (PyPI): 91 Forks (GitHub): 0 Stars (GitHub): 1 |
Not marked |
Each figure is the marketplace's own and is never added up across marketplaces. A marketplace that publishes no figure shows none: no number is not zero.
What changed
Nothing has moved on this plugin since we started watching it.
Similar plugins
Products whose own names, descriptions, tools and skills are closest in meaning to this one, on every marketplace we read. Closeness is ranked within this list only.
-
MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.
-
Read, render, search, and manage reMarkable documents through MCP
-
Model Context Protocol server for the DocAuto document-generation API.
-
fastmcp-pdftools io.github.atarkowska/fastmcp-pdftools
An MCP server that provides [describe what your server does]
-
docspell-mcp io.github.mrfentmen/docspell-mcp
Docspell document search, items and version.
-
documenso-mcp io.github.mrfentmen/documenso-mcp
MCP server for Documenso: documents, recipients. Works with any instance.
-
teedy-mcp io.github.mrfentmen/teedy-mcp
Teedy document management: login, documents, files.
-
MCP server for the Google Docs API: read and edit documents, styles, tables, images, comments.
-
paper-mcp io.github.MCPServings/paper-mcp
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
-
laserfiche-mcp io.github.SamuelSHernandez/laserfiche-mcp
MCP server for self-hosted Laserfiche repositories — search and read documents from Claude.
Similar plugins by marketplace
The same question asked of one marketplace at a time: is there an analog of this plugin there?
Has a listing on Claude Code: claude-plugins-community (5)
-
Zero-config MCP server for searchable documentation. SQLite or PostgreSQL.
-
Connect AI assistants to Outline for document search, reading, and management
-
Interactively explore MCP server tools and their input schemas. mcpx lets you drill down from server → tool → schema to understand what each tool expects. Browse all configured…
-
One MCP, many parsers. Routes between markitdown, Docling, and LlamaParse. Plus an interpret tool…
-
mcp-server io.github.cap-js/mcp-server
Model Context Protocol (MCP) server for AI-assisted development of CAP applications.
Has a listing on Claude Code: claude-plugins-official (5)
-
mcp-server io.github.cap-js/mcp-server
Model Context Protocol (MCP) server for AI-assisted development of CAP applications.
-
mdk-mcp-server io.github.SAP/mdk-mcp-server
Model Context Protocol (MCP) server for AI-assisted development of MDK applications.
-
MCP server for terminal commands, file operations, and process management
-
Skills for creating MCP Apps with the MCP Apps SDK
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
Has a listing on Claude: knowledge-work-plugins (5)
-
MCP server for terminal commands, file operations, and process management
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Connect sources and search processed documents with Unstructured Foundation. Provides MCP access to source setup, processing status, document search, and document retrieval.
-
View, annotate, and sign PDFs in a live interactive viewer. Mark up contracts, fill forms with visual feedback, stamp approvals, and place signatures — then download the annotated…
-
Work with your Box content directly from Claude Code — search files, organize folders, collaborate with your team, and use Box AI to answer questions, summarize documents, and…
Has a listing on Codex: openai-curated (openai/plugins) (5)
-
Work with Zotero from Codex: search your library, export BibTeX, insert citations, and import references through the Zotero desktop app.
-
Use Google Drive as the single entrypoint for Drive, Docs, Sheets, and Slides work.
-
Work with SharePoint using the configured Microsoft SharePoint app connector.
-
Install, open, and connect the signed ChatCut Desktop app from Codex.
-
Work with Gmail using the configured Gmail app connector.
Has a listing on Community GitHub marketplaces (5)
-
Create, send, negotiate, sign, and track contracts with Common Paper.
-
Section-level doc search for .md, .rst, .adoc, .ipynb, .html, .yaml, .json, and OpenAPI specs.
-
FastMCP server exposing Joplin notes, notebooks, tags, and imports.
-
mcpship: check and publish MCP servers
Checks a remote MCP server against the Claude directory rules and guides its publication.
-
scribo io.github.causa-prima-ai/scribo
EN 16931-compliant e-invoices: XRechnung, ZUGFeRD, Factur-X, Peppol BIS, Facturae or US PDF. Free.
Has a listing on Copilot CLI: github/awesome-copilot (5)
-
Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a…
-
Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating…
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and…
-
Safe BLE diagnostics, evidence workflows, and guarded automation for AI agents.
Has a listing on Copilot CLI: github/copilot-plugins (5)
-
mcp-apps
Generate MCP App widgets for MCP tools. Produces self-contained HTML widgets using the MCP Apps protocol.
-
Build Power Apps Canvas Apps using the Canvas Authoring MCP server.
-
workiq
Query Microsoft 365 data with natural language — emails, meetings, documents, Teams messages, and more.
-
Toolkit for building Microsoft 365 Copilot declarative agents — scaffolding, JSON manifest development, and capability configuration.
-
model-apps
Build and deploy Power Apps generative pages for model-driven apps with specialist agents for planning, entity creation, and parallel code generation. Requires PAC CLI >= 2.7.0…
Has a listing on Cursor: cursor/plugins (5)
-
Capture, search, and organize notes and collections.
-
Manage envelopes, templates, workflows, and agreements.
-
Let Grok Bot reach MCP servers on your private Tailscale network. Sign in to Tailscale to connect your tailnet; Grok Bot joins it as one tagged device and only reaches the hosts…
-
Search docs, read pages, and update tables.
-
Search and read Microsoft SharePoint sites, document libraries, files, and lists.
Has a listing on Docker MCP Catalog (5)
-
A minimal Model Context Protocol (MCP) server for Alfresco providing tools via the Alfresco REST API.
-
The Official Model Context Protocol (MCP) server for Kagi Search & other tools.
-
Pull up-to-date, version-specific documentation and code examples for any library or framework straight into your prompt.
-
Dynatrace-mcp io.github.dynatrace-oss/Dynatrace-mcp
[DEPRECATED] Dynatrace MCP Server. Migrate to dynatrace-for-ai or Dynatrace Remote MCP Server.
-
MCP server for terminal commands, file operations, and process management
Has a listing on Official MCP Registry (5)
-
MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.
-
Read, render, search, and manage reMarkable documents through MCP
-
Model Context Protocol server for the DocAuto document-generation API.
-
fastmcp-pdftools io.github.atarkowska/fastmcp-pdftools
An MCP server that provides [describe what your server does]
-
docspell-mcp io.github.mrfentmen/docspell-mcp
Docspell document search, items and version.
Found by meaning, not by shared code or a shared repository: similar plugins stay separate products, and this is not a review or a recommendation.
Is this your plugin?
Add it to your projects and prove you maintain it with a file in its repository, a file on your domain or a DNS record. You get alerts when a marketplace lists it, drops it, changes its verified mark or what it asks for, and its remote endpoint goes on monitoring as a web service.
Data comes from the Official MCP Registry (registry.modelcontextprotocol.io), CC0 1.0. Figures come from our own regular passes over the marketplaces, last read on . We publish no contact details for plugin publishers.