Paperless MCP Server

An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags

Local serverstdioTypeScript

What is the Paperless MCP Server?

An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and

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_documentsParameters: - page (optional): Page number - page_size (optional): Number of documents per page
get_document
search_documents
download_documentParameters: - id: Document ID - original (optional): If true, downloads original file instead of archived version
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_documentParameters: - file: Base64 encoded file content - filename: Name of the file - title (optional): Title for the document - created (optional): DateTime when the document was created (e.g. "2024-01-19" or "2024-01-19 06:15
list_tags
create_tagParameters: - name: Tag name - color (optional): Hex color code (e.g. "#ff0000") - match (optional): Text pattern to match - matching_algorithm (optional): One of "any", "all", "exact", "regular expression", "fuzzy"
list_correspondents
create_correspondentParameters: - name: Correspondent name - match (optional): Text pattern to match - matching_algorithm (optional): One of "any", "all", "exact", "regular expression", "fuzzy"
list_document_types
create_document_typeParameters: - name: Document type name - match (optional): Text pattern to match - matching_algorithm (optional): One of "any", "all", "exact", "regular expression", "fuzzy"

How to install the Paperless MCP Server

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": ["-y", "paperless-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Paperless to Installation.”
  • “Use Paperless to list documents.”
  • “Use Paperless to get document.”

Frequently asked questions

A running Paperless-NGX instance and a valid API token from that instance.