Paperless-NGX MCP Serverとは？
これは、元祖の Paperless-ngx MCP サーバーである nloui/paperless-mcp の、保守が続いているフォークです。元のリポジトリの最後のコミットは 2025 年 11 月 11 日で した。Baruch Rothkoff のフォーク（baruchiro/paperless-mcp）の GitHub スター数は約 149 で、元の 248 より少ないですが、今もリリースを続けているのはこちらです。v2.2.1 は 2026 年 9 月 11 日に公開され、npm パッケージは 2026 年 10 月 29 日までの 1 週間で 683 回ダウンロードされました。元のものは 171 回でした。
Paperless-ngx の REST API を、文書、メモ、タグ、差出人、文書タイプ、カスタムフィールド、メールアカウントとルールを扱う約 31 個のツールで包んでいます。npx -y @baruchiro/paperless-mcp@latest で stdio 経由で動かすか、ポート 3000 で Streamable HTTP と SSE を提供する Docker イメージとして動かします。Paperless-ngx インスタンスの URL と、プロフィールページで取得する API トークンが必要です。リポジトリのライセンスは ISC です。
Paperless-NGX MCP Serverのインストール方法
npx -y @baruchiro/paperless-mcp@latestPaperless-NGX MCP Serverは使う価値があるか？
手紙、請求書、税務書類をすでに Paperless-ngx に保管している人にとって、このサーバーはアーカイブをエージェントが検索し、整理し直せるものに変えます。query_documents は、全文検索、類似文書の検索、そして請求書番号のない請求書をすべて探すような、カスタムフィールドを使った構造化クエリをそのまま渡します。人が Web インターフェースで行うことの大半をカバーしています。
ツール一覧は読み取りをはるかに超えています。bulk_edit_documents は文書の結合、分割、回転、ページの削除、文書の削除、権限 の変更ができます。post_document は 100 MB までのファイルをアップロードします。メールのツールは、Paperless が受信箱から何を取り込むかを決めるルールを作成、編集します。明示的な確認フラグを求めるのは、メモとメールルールの削除だけです。一括削除は求めないので、クライアントの承認プロンプトが唯一の防御です。
元のものではなくこのフォークを選ぶ主な理由は、セキュリティへの取り組みです。バージョン 2.0.0 で、HTTP モードは Bearer トークンのないリクエストを拒否するようになりました。以前は、ネットワーク上のどの呼び出し元に対してもサーバー自身のキーで応答してしまうエンドポイントで、それが塞がれました。現在は HTTP クライアントがそれぞれ自分の Paperless トークンを送るので、Paperless の権限がユーザーごとに適用されます。ファイルパスによるアップロードは、PAPERLESS_MCP_UPLOAD_PATHS で制限しない限り、プロセスから見えるどのファイルでも読み込みます。そしてこの変数は任意です。
弱点は、メンテナー 1 人のコミュニティサーバーによくあるものです。Paperless-ngx v3.0.0 で 9 未満の REST API バージョンが廃止され、古い設定では PAPERLESS_API_VERSION を設定するまで HTTP 406 エラーになります。ドキュメントはドキュメントサイトではなく長い README です。スキャンした郵便物の文書テキストは信頼できない入力なので、それを読むエージェントは、アーカイブへの書き込み権限を持ったまま、プロンプトインジェクションにさらされます。
真価を発揮する場面
5 年分の請求書と領収書を Paperless-ngx に保管しているフリーランス
確定申告の前に、請求書番号がまだない 2025 年の請求書をすべて見つける
カスタムフィールドのクエリを付けた query_documents で漏れを一覧にし、bulk_edit_documents でフォローアップ用のタグを付けます。既存の Paperless の環境があれば無料で、コストは数回のツール呼び出しと、一括編集ごとの確認です。
家庭の郵便物をスキャンして Paperless に入れているホームラボの持ち主
公共料金の請求書がメールから取り込まれ、自動でタグ付けされるようにメールルールを設定する
エージェントがメールアカウントを一覧にし、差出人と件名のフィルター、付けるタグを指定して create_mail_rule を呼び出します。アカウントのパスワードはツールの出力から伏せられますが、誤ったルールは実際の受信箱のメールに印を付けたり移動したりすることがあります。
顧客ファイル用に Paperless をセルフホストしている小さな会計事務所
どの顧客の文書を誰が見られるかを守るアシスタントを、2 人のスタッフに与える
Docker イメージを HTTP モードで動かし、各クライアン トに自分の Paperless トークンを Bearer ヘッダーで送らせて、Paperless の権限が人ごとに適用されるようにします。サーバーは公開インターネットから切り離し、--no-auth は設定しないでください。
導入前に確認すること
- 導入
- PAPERLESS_URL と PAPERLESS_API_KEY を付けて npx -y @baruchiro/paperless-mcp@latest をクライアントの設定に追加するか、ポート 3000 で HTTP と SSE を使うなら ghcr.io/baruchiro/paperless-mcp を実行します。README には Cursor のインストールリンクと Continue の例があります。トークンがあれば数分で済みます。
- 連携
- 約 31 個のツールがあります。文書の一覧、クエリ、ダウンロード、アップロード、サムネイル、メモ、タグ、差出人、文書タイプ、カスタムフィールド、メールアカウントとルールです。およそ半分が書き込みを行います。
- データとプライバシー
- API トークンが届くものすべてで、削除も含みます。v2.0.0 以降の HTTP モードでは、--no-auth を設定しない限り、各リクエストが自分の Bearer トークンを持つ必要があります。ファイルパスによるアップロードは、PAPERLESS_MCP_UPLOAD_PATHS を設定しない限り、どのローカルファイルでも読み込みます。GitHub のセキュリティアドバイザリは公開されていません。
- 大規模利用時のコスト
- 無料です。Paperless-ngx はセルフホストなので、コストはサーバーとモデルのトークンだけです。大きな結果のページと base64 でのアップロードが、コンテキストを膨らませる主な原因です。
- 制限
- Paperless-ngx v3.0.0 は 9 未満の API バージョンを HTTP 406 で拒否します。search_documents は非推奨で、query_documents が推奨されています。破壊的な一括操作には確認フラグがありません。
良い点
- カスタムフィールドのクエリやメールルールを含む約 31 個のツール
- v2.0.0 以降、HTTP モードではリクエストごとに Bearer トークン
- npx と Docker イメージがあり、実際の Paperless-ngx に対するエンドツーエンドのテストを実行している
- 元のリポジトリと違い、活発に保守されている
気になる点
- 一括削除、結合、分割が確認フラグなしで実行される
- 許可リストを設定しない限り、ファイルパスによるアップロードは無制限
- メンテナーは 1 人で、スターは約 149
- Paperless-ngx 3.0 以降、古い設定では HTTP 406 になる
おすすめの人
エージェントに文書の検索、タグ付け、整理をさせたい、書き込みの呼び出しを承認プロンプトの後ろに置いておける Paperless-ngx の利用者。
Paperless-NGX MCP Serverの代替
Paperless-NGX MCP Server：よくある質問
- Paperless-NGX MCP Serverは使う価値があるか？
- インストールする価値のある Paperless-ngx サーバーです。書類整理係の 1 日の仕事をすべてこなせるほど幅広く、任せればアーカイブを消せるほど幅広くもあります。 評価は5点満点中3.8点です。
- Paperless-NGX MCP Serverの料金は？
- 無料のオープンソース（ISC）です。Paperless-ngx 自体も無料でセルフホストします。
- Paperless-NGX MCP Serverの欠点は？
- 一括削除、結合、分割が確認フラグなしで実行される; 許可リストを設定しない限り、ファイルパスによるアップロードは無制限; メンテナーは 1 人で、スターは約 149; Paperless-ngx 3.0 以降、古い設定では HTTP 406 になる.
- Paperless-NGX MCP Serverは誰に向いているか？
- エージェントに文書の検索、タグ付け、整理をさせたい、書き込みの呼び出しを承認プロンプトの後ろに置いておける Paperless-ngx の利用者。
- チームや本番環境でPaperless-NGX MCP Serverを使うと費用はいくらか？
- 無料です。Paperless-ngx はセルフホストなので、コストはサーバーとモデルのトークンだけです。大きな結果のページと base64 でのアップロードが、コンテキストを膨らませる主な 原因です。
- Paperless-NGX MCP Serverは企業データを扱っても安全か？
- API トークンが届くものすべてで、削除も含みます。v2.0.0 以降の HTTP モードでは、--no-auth を設定しない限り、各リクエストが自分の Bearer トークンを持つ必要があります。ファイルパスによるアップロードは、PAPERLESS_MCP_UPLOAD_PATHS を設定しない限り、どのローカルファイルでも読み込みます。GitHub のセキュリティアドバイザリは公開されていません。
- Paperless-NGX MCP Serverの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はFilesystem (reference server), MarkItDown MCP 、 Zotero MCPです。
回答確認日：2026年10月31日