Подключите агентов ИИ к Paperless-ngx. Этот сервер Model Context Protocol предоставляет API Paperless-ngx REST в виде 115+ инструментов, поэтому такие помощники, как Клод, могут искать, загружать, отмечать и организовывать ваши документы — с дополнительным семантическим поиском по всему вашему архиву с использованием локальных векторных вставок.

Работает с любым клиентом MCP: Claude Code, Claude Desktop или вашим собственным агентом.

Основные моменты

Полное управление документами — поиск, загрузка, загрузка, обновление и массовый редактирование документов; управление тегами, корреспондентами, типами документов, путями хранения, пользовательскими полями и сохраненными просмотрами Семантический поиск (необязательно) — поиск векторного сходства с встраиванием OpenAI или Ollama, хранящимся локально в sqlite-vec; никакого внешнего вектора DB AI-assisted workflows — автоматически классифицируйте документы, обрабатывайте свой почтовый ящик, массовый тег по содержанию ** Почта, обмен и мусор** — настройте учетные записи и правила почты, создайте общедоступные ссылки на обмен, документы электронной почты и восстановите из мусора **Бесплатный ngx 3.0 готов ** — версии документов, редактирование PDF, совместные пакеты и управление задачами, а версия REST API прикреплена так, что 2.x и 3.x ведут себя предсказуемо

paperless-mcp

Connect AI agents to Paperless-ngx. This Model Context Protocol server exposes the Paperless-ngx REST API as 115+ tools, so assistants like Claude can search, upload, tag, and organize your documents — with optional semantic search over your whole archive using local vector embeddings.

Works with any MCP client: Claude Code, Claude Desktop, or your own agent.

Highlights

• Full document management — search, upload, download, update, and bulk-edit documents; manage tags, correspondents, document types, storage paths, custom fields, and saved views
• Semantic search (optional) — vector similarity search with OpenAI or Ollama embeddings, stored locally in sqlite-vec; no external vector DB
• AI-assisted workflows — auto-classify documents, process your inbox, bulk-tag by content
• Mail, sharing, and trash — configure mail accounts and rules, create public share links, email documents, and restore from the trash
• Paperless-ngx 3.0 ready — document versions, PDF editing, share bundles, and task management, with the REST API version pinned so 2.x and 3.x both behave predictably
• Single- or multi-user — stdio transport for personal use, or an HTTP transport where every user authenticates with their own Paperless token and only sees their own documents
• Docker-ready — prebuilt image on GHCR, drop-in sidecar for your Paperless-ngx compose stack

Things you can ask once it’s connected:

“Find all invoices from my ISP in 2025 and tag them as telecom”

“Upload this PDF, set the correspondent to my landlord, and file it as a contract”

“Which documents in my inbox are missing a correspondent or document type?”

“Give me just the page of my insurance policy that mentions the deductible, as a PDF”

“Find the document about the espresso machine warranty” (semantic search — no keyword match needed)

Quick start

The package is published as @orellbuehler/paperless-mcp and runs directly with npx — no clone or build needed.

1. Get your API token from Paperless-ngx (Settings > Administration, or POST /api/token/)
2. Register the server with your MCP client. With Claude Code:

claude mcp add paperless \
  --env PAPERLESS_URL=https://your-paperless-instance.example.com \
  --env PAPERLESS_TOKEN=your-api-token \
  -- npx -y @orellbuehler/paperless-mcp