orellbuehler/paperless-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

16 stars 3 forks 品質 82 トレンド 35MIT

MCP server for Paperless-ngx — lets AI agents like Claude search, upload, tag, and organize your documents, with optional local semantic search

概要

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. - — search, upload, download, update, and bulk-edit documents; manage tags, correspondents, document types, storage paths, custom fields, and saved views - — vector similarity search with OpenAI or Ollama embeddings, stored locally in sqlite-vec; no external vector DB - — auto-classify documents, process your inbox, bulk-tag by content - — configure mail accounts and rules, create public share links, email documents, and restore from the trash - — document versions, PDF editing, share bundles, and task management, with the REST API version pinned so 2.x and 3.

README

以下は原文 README の抜粋です。原文を見る。

paperless-mcp

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.

Get your API token from Paperless-ngx (Settings > Administration, or POST /api/token/)
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

GitHub で README 全文を見る

インストール

npx -y @orellbuehler/paperless-mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "paperless": {
      "command": "npx",
      "args": ["-y", "@orellbuehler/paperless-mcp"],
      "env": {
        "PAPERLESS_URL": "https://your-paperless-instance.example.com",
        "PAPERLESS_TOKEN": "your-api-token"
      }
    }
  }
}