Paperless MCP Server

Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags

Local serverstdioTypeScript

What is the Paperless MCP Server?

Paperless MCP lets Claude, Cursor and other MCP clients work with Paperless MCP directly. Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents, and document types through the Paperless-NGX API.

What Paperless MCP does

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.

Practical notes

  • Maintained by baruchiro, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_documentsGet a paginated list of documents with simple filters. Use this for straightforward listing tasks. For full-text queries, structured custom field filtering, or advanced Paperless filters, use query_documents.
query_documentsCanonical document query tool. Supports full-text querying, simple Paperless search, custom field filters, and documented /api/documents/ Paperless query parameters.
get_document
search_documentsDeprecated compatibility wrapper for full-text search. Prefer query_documents({ query: ... }) for new integrations.
download_documentParameters: - id: Document ID - original (optional): If true, downloads original file instead of archived version
get_document_thumbnailGet a document thumbnail (image preview) by ID. Returns the thumbnail as a base64-encoded WebP image resource.
bulk_edit_documentsParameters: - documents: Array of document IDs - method: One of: - set_correspondent: Set correspondent for documents - set_document_type: Set document type for documents - set_storage_path: Set storage path for document
post_document1. **Base64 mode** (traditional): Provide file (base64-encoded content) + filename 2. **Filesystem mode** (efficient): Provide file_path (absolute path on server)
list_document_notes
create_document_noteAdd 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

Configuration

VariableDescriptionRequired
PAPERLESS_URLEndpoint or connection string the server talks to.Yes
PAPERLESS_API_KEYCredential the server authenticates with.Yes
PAPERLESS_PUBLIC_URLEndpoint or connection string the server talks to.Yes
PAPERLESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Paperless MCP to Scenario.”
  • “Use Paperless MCP to Installation.”
  • “Use Paperless MCP to list documents.”

Frequently asked questions

Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.