Back to Browse

Paperless Ngx MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.

About

MCP server for Paperless-ngx 3.x — full REST API coverage, schema-aware, token-frugal.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

6 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of the Paperless-ngx instanceOptional

Environment variable: PAPERLESS_URL

Paperless-ngx API tokenRequired

Environment variable: PAPERLESS_TOKEN

URL used when building links, if the instance is reachable under a different name from outsideOptional

Environment variable: PAPERLESS_PUBLIC_URL

Comma-separated toolsets, or allOptional

Environment variable: PAPERLESS_TOOLSETS

Expose only tools that cannot change anythingOptional

Environment variable: PAPERLESS_READ_ONLY

Extra request headers; needed behind forward-auth proxies such as AuthentikOptional

Environment variable: PAPERLESS_HEADERS

Where downloaded files are writtenOptional

Environment variable: PAPERLESS_DOWNLOAD_DIR

Hard ceiling on list page sizesOptional

Environment variable: PAPERLESS_MAX_PAGE_SIZE

Request timeout in millisecondsOptional

Environment variable: PAPERLESS_TIMEOUT_MS

REST API version sent in the Accept headerOptional

Environment variable: PAPERLESS_API_VERSION

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-tobee89-mcp-paperless-ngx": {
      "env": {
        "PAPERLESS_URL": "your-paperless-url-here",
        "PAPERLESS_TOKEN": "your-paperless-token-here",
        "PAPERLESS_HEADERS": "your-paperless-headers-here",
        "PAPERLESS_TOOLSETS": "your-paperless-toolsets-here",
        "PAPERLESS_READ_ONLY": "your-paperless-read-only-here",
        "PAPERLESS_PUBLIC_URL": "your-paperless-public-url-here",
        "PAPERLESS_TIMEOUT_MS": "your-paperless-timeout-ms-here",
        "PAPERLESS_API_VERSION": "your-paperless-api-version-here",
        "PAPERLESS_DOWNLOAD_DIR": "your-paperless-download-dir-here",
        "PAPERLESS_MAX_PAGE_SIZE": "your-paperless-max-page-size-here"
      },
      "args": [
        "-y",
        "mcp-paperless-ngx"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!