paperless-mcp
paperless-mcp is an MCP server, listed under mcp tooling. It reaches paperless. It needs PAPERLESS_API_KEY and PAPERLESS_TOKEN to authenticate. Its repository has 148 GitHub stars and is licensed under ISC; we last read it on 2026-10-22.
This server implements the Model Context Protocol to interact with a Paperless-NGX API server, providing tools for managing documents, tags, correspondents, and document types.
Install
MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. paperless-mcp’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.
What it reaches, and what it needs
Maintenance
An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.
What paperless-mcp can do
14 tools documented in its README. An AI client calls these by name.
list_documents- Get a paginated list of documents with simple filters.
query_documents- Canonical document query tool. Supports full-text querying, simple Paperless search, custom field filters, and more.
download_document- Download a document file by ID.
get_document_thumbnail- Get a document thumbnail (image preview) by ID. Returns the thumbnail as a base64-encoded WebP image resource.
bulk_edit_documents- Perform bulk operations on multiple documents.
post_document- Upload a new document to Paperless-NGX.
list_document_notes- List all notes attached to a document.
create_document_note- Add a note to a document. Returns the document's full list of notes.
delete_document_note- ⚠️ Delete a single note from a document by its note ID. This operation is irreversible.
list_tags- Get all tags.
create_tag- Create a new tag.
list_correspondents- Get all correspondents.
create_correspondent- Create a new correspondent.
list_document_types- Get all document types.
Read from the README; names are kept only if the README contains them.
paperless-mcp compared with similar servers
| Server | Reaches | Needs | Stars | Last update | Licence |
|---|---|---|---|---|---|
| paperless-mcp (this page) | paperless | PAPERLESS_API_KEY, PAPERLESS_TOKEN | 148 | 2026-09-15 | ISC |
| tradingview-mcp | marketaux | MARKETAUX_API_TOKEN | 5,099 | 2026-10-21 | MIT |
| mcphub | — | ADMIN_PASSWORD | 2,580 | 2026-10-24 | Apache-2.0 |
| mcp-remote | — | AUTH_TOKEN, MCP_CLIENT_SECRET, MCP_REMOTE_CLIENT_SECRET | 1,652 | 2026-10-20 | MIT |
| mcp-searxng | — | None listed | 1,322 | 2026-10-20 | MIT |
| tuui | — | None listed | 1,159 | 2026-05-14 | Apache-2.0 |
Ranked by services in common with paperless-mcp, then by stars. Figures are from each repository when we last read it.
Common questions about paperless-mcp
- What does paperless-mcp do?
- This server implements the Model Context Protocol to interact with a Paperless-NGX API server, providing tools for managing documents, tags, correspondents, and document types.
- How do I install paperless-mcp?
- Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/baruchiro/paperless-mcp
- What does paperless-mcp connect to, and what does it need?
- It reaches paperless. The credentials we found in its source are PAPERLESS_API_KEY and PAPERLESS_TOKEN.
- Is paperless-mcp official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 148 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-09-15.
- What licence does paperless-mcp use?
- The repository declares the ISC licence.
More MCP servers for mcp tooling
- tradingview-mcp5,099 stars
- mcphub2,580 stars
- mcp-remote1,652 stars
- mcp-searxng1,322 stars
- tuui1,159 stars
- mcp-proxy741 stars