Paperless-ngx MCP Server

by cubinet-code Your server? Claim it

local only

Paperless-ngx runs on your own machine — the client starts it, so there is no endpoint to ping. 211 installs a week from npm. Last commit 30 Sep 2026.

Full Paperless-ngx API for AI assistants: search, tag, edit and upload documents, workflows and more

Installs per day peak 187 · avg 48 · -32% w/w

a month agotoday

211

Installs / week

npm · paperless-ngx-mcp

Stars

1 open issue

30 Sep 2026

Last commit

5 releases in 90 days

ISC

License

TypeScript

Nothing serious here today

Today is the operative word: we check Paperless-ngx every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

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 Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add paperless-ngx-mcp -- npx -y paperless-ngx-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.paperless-ngx-mcp]
command = "npx"
args = ["-y", "paperless-ngx-mcp"]

.cursor/mcp.json

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

.vscode/mcp.json

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

This one needs environment variables set before it will start: PAPERLESS_URL (Base URL of your Paperless-ngx instance, e.g. https://paperless.example.com), PAPERLESS_API_KEY (Paperless-ngx API token (My Profile → generate token)), PAPERLESS_PUBLIC_URL (Public URL used for browser links to documents. Defaults to PAPERLESS_URL.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Paperless-ngx

same job, measured the same way

AI-ERD

by codelives

AI-ERD MCP connector for workspace, document, ERD, diagram, task, and attachment workflows.

133 installs/wk local only

Vectr

by swapnanil

Semantic codebase search + persistent working memory for AI code editors. Local, no API key.

150 installs/wk local only

Codealive MCP

by codealive-ai

Semantic code search and analysis from CodeAlive for AI assistants and agents.

local only

Vectora

by brunosrz

AI assistant with RAG, web search, filesystem and memory. MCP sub-agent for Claude Code.

49 installs/wk local only

Docdex

by bekirdag

Fast per-repo documentation indexer and full-text search MCP server for codebases.

688 installs/wk local only

GitHub

by aifity

Connect AI assistants to GitHub - manage repos, issues, PRs, workflows, and git operations.

local only

Cesium MCP Dev

by gaopengbin

CesiumJS API docs, code generation and development tools for IDE AI assistants.

86 installs/wk local only

Foxmayn Frappe CLI

by nasroykh

Read and change documents, reports and workflows on Frappe and ERPNext sites.

local only

Paperless-ngx — questions

Answers built from our own checks of this server.

Why is there no uptime for Paperless-ngx?

Paperless-ngx runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package paperless-ngx-mcp was installed 211 times last week.

How do I connect Paperless-ngx?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls paperless-ngx-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Paperless-ngx?

The npm package paperless-ngx-mcp was installed 211 times in the last week. Week over week that is -32%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Paperless-ngx open source?

Yes — it is published under the ISC licence, written in TypeScript, 9 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.