Paperless MCP Server

Model Context Protocol (MCP) server for Paperless-NGX. Lets AI assistants manage documents, tags, correspondents, document types, custom fields

Local serverstdioTypeScript

What is the Paperless MCP Server?

Model Context Protocol (MCP) server for Paperless-NGX. Lets AI assistants manage documents, tags, correspondents, document types, custom fields, saved views

What you get

Works with Paperless-ngx 2.x and 3.x. Where the two differ on the wire the server adapts automatically, so the same tools work against either.

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
triage_inboxWalks the assistant through inbox triage: gather existing tags / correspondents / document types, propose metadata for each inbox document **preferring existing items**, present a confirmation table, and only apply chang
edit_documents_bulkParameters: - documents: array of document IDs - method: one of set_correspondent, set_document_type, set_storage_path, add_tag, remove_tag, modify_tags, modify_custom_fields, delete, reprocess, set_permissions, merge, s
post_documentParameters: file, filename, plus optional title, created, correspondent, document_type, storage_path, tags, archive_serial_number, custom_fields, poll, poll_timeout_seconds.

How to install the Paperless MCP Server

{
  "mcpServers": {
    "paperless-ngx": {
      "command": "npx",
      "args": ["-y", "paperless-ngx-mcp"],
      "env": {
        "PAPERLESS_URL": "your-value",
        "PAPERLESS_API_KEY": "your-value",
        "PAPERLESS_PUBLIC_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

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

Example prompts to try

  • “Use Paperless to Configuration.”
  • “Use Paperless to Documents.”
  • “Use Paperless to Tags.”

Frequently asked questions

Model Context Protocol (MCP) server for Paperless-NGX. Lets AI assistants manage documents, tags, correspondents, document types, custom fields, saved views Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.