Paperless MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add paperless-mcp -- uvx pvliesdonk-paperless-mcp

{
  "mcpServers": {
    "paperless-mcp": {
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "command": "uvx"
    }
  }
}

[mcp_servers.paperless-mcp]
command = "uvx"
args = ["pvliesdonk-paperless-mcp"]

{
  "mcpServers": {
    "paperless-mcp": {
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "command": "uvx"
    }
  }
}

{
  "mcpServers": {
    "paperless-mcp": {
      "args": [
        "pvliesdonk-paperless-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: PAPERLESS_MCP_KV_STORE_URL (Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `mongodb://` each need their matching extra. When unset, defaults to `file:///data/state` (the volume family Docker images mount), or to `memory://` (with a warning) on a host where that directory is not usable.), PAPERLESS_MCP_TOOLS_ALLOW (Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_deny`. Takes effect through `apply_tool_visibility`.), PAPERLESS_MCP_TOOLS_DENY (Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effect through `apply_tool_visibility`.), PAPERLESS_MCP_SERVER_NAME (Rename this server instance; defaults to the project name.), PAPERLESS_MCP_INSTANCE_DESCRIPTION (Concise routing context that distinguishes this deployment's material or responsibility.), PAPERLESS_MCP_INSTRUCTIONS_EXTRA (Deployment-specific behavioral policy added to the generated MCP instructions.), PAPERLESS_MCP_INSTRUCTIONS (Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).), FASTMCP_LOG_LEVEL (Log level for FastMCP internals and app loggers (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG.), FASTMCP_ENABLE_RICH_LOGGING (Rich color output for a terminal; false gives one plain or JSON line per record. Off in the container image and the systemd unit, since neither is a terminal and Rich wraps a structured record at its 80-column fallback.), PAPERLESS_MCP_PAPERLESS_URL (Base URL of the Paperless-NGX REST API, without a trailing slash. The server refuses to start without it.), PAPERLESS_MCP_API_TOKEN (Paperless service-account token used for outbound API requests. The server refuses to start without it.), PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS (Per-request HTTP timeout in seconds.), PAPERLESS_MCP_HTTP_RETRIES (Retries for idempotent requests after network errors or 5xx responses.), PAPERLESS_MCP_DEFAULT_PAGE_SIZE (Default page size for list tools, from 1 through 100.), PAPERLESS_MCP_PAPERLESS_PUBLIC_URL (Public Paperless UI URL for user-visible links; defaults to PAPERLESS_URL.). The author declared them in the registry entry; get the values from the project itself.