Zotero Native MCP

zotero-native-mcp

Zotero 10 以降のライブラリを、完全にオフラインで読み取り、書き込みもできる MCP サーバーです。

Zotero を Claude、Claude Code、Cursor、または任意の Model Context Protocol クライアントに接続します。アシスタントはライブラリを検索したり、PDF の全文を読んだり、コレクションを作成したり、参考文献を追加したり、ディスク上の PDF を添付したりできます。

すべての操作は 127.0.0.1 上の Zotero アプリケーションに対して実行されます。zotero.org アカウントは不要です。Web API キーも不要です。Zotero プラグインも不要です。クラウドとの往復もありません。

これが作られた理由

Zotero 10 では、組み込みのローカル API に書き込み機能が追加されました。それ以前は、すべての Zotero MCP サーバーが読み取り専用のローカルエンドポイントを回避する必要がありました。書き込みを api.zotero.org 経由にする（遅く、API キーが必要で、ライブラリをクラウドに同期する必要があります）か、別の Zotero プラグインを同梱し、インストールして最新の状態に保つ必要がありました。

このサーバーは、ネイティブの機能を直接使用します。Zotero 内にインストールするものも、管理する認証情報もありません。また、ネットワークに一切アクセスしないため、読み取りは8～60 msで完了します。

要件

• Zotero 10 以降が起動していること。これは最低要件であり、推奨ではありません。ローカル API 経由の書き込み機能は Zotero 10 より前には存在しません。Zotero 7～9 では読み取りツールは動作しますが、書き込みはすべて失敗します。
• Zotero → Settings → Advanced → **「Allow other applications on this computer to communicate with Zotero」**を有効にします。
• Node.js 22 以降。Node 20 は 2026 年 4 月にサポート終了となりました。

テスト済み環境

以下は、動作させる意図ではなく、検証した証拠を示しています。それ以外のプラットフォームやクライアントでも動作する見込みです。このサーバーは、設計上プラットフォーム固有の要素を含まない、127.0.0.1 と通信するポータブルな TypeScript です。ただし、以下の表にない環境は検証しておらず、これが確認できている範囲のすべてです。

CI では、Linux、macOS、Windows × Node 22、24、26のマトリックス全体で、ユニットテストとモックプロトコルテストを実行するため、コード自体のポータビリティは 3 つのプラットフォームすべてで確認されています。どのランナーでも確認できないのは、実際の Zotero とのやり取りです。ランナーには Zotero がインストールされていないためです。この部分は手動で実施しました。scripts/coverage.mjs を使い、稼働中のライブラリに対して、3 つすべてのオペレーティングシステムで28 個すべてのツールを実行しています。

**未検証です。**Intel Mac、スクリプトのみを実行した Linux 上の Claude Code、ならびに Claude Desktop、Cursor など、あらゆる環境でのその他の MCP クライアント。

この一覧にない環境で実行した場合は、動作したかどうかの報告を歓迎します。今、このプロジェクトにとって最も役立つ報告です。

まずライブラリをバックアップしてください

警告

このサーバーは、Zotero ライブラリ内のアイテムを変更および削除できます。 開始する前にバックアップし、その後も定期的にバックアップしてください。

削除はデフォルトで元に戻せます。zotero_delete_items と zotero_delete_collection はアイテムを Zotero のゴミ箱 に移動します。Zotero のウィンドウから、または zotero_restore_items を使って復元できます。ただし、Zotero はそのゴミ箱を30日後に自動的に空にします。また、両方のツールでは permanent: true を指定でき、指定すると完全に消去されます。元に戻すことはできず、添付ファイルはディスクから削除され、API から復元する方法もありません。zotero_empty_trash は、すでにゴミ箱にあるすべてのアイテムに対して同じ処理を行います。

これらのツールは、自然言語の指示を解釈するアシスタントによって操作されるため、どのアイテムを指しているのかを誤認する可能性があります。

バックアップ方法： Zotero を終了してから、データディレクトリ全体をコピーしてください。macOS と Linux では ~/Zotero、Windows では %USERPROFILE%\Zotero、または Settings → Advanced → Files and Folders に表示される場所です。このディレクトリには zotero.sqlite と、すべての添付ファイルを含む storage フォルダが格納されています。Zotero の公式ガイダンスは zotero.org/support/zotero_data をご覧ください。

zotero.org との同期はバックアップではありません。削除も同期されます。

このソフトウェアは現状有姿で提供され、いかなる種類の保証もありません。また、作者はデータ損失に対して一切の責任を負いません。LICENSE をご覧ください。

クイックスタート

claude mcp add --scope user zotero-native-mcp -- npx -y zotero-native-mcp

{
  "mcpServers": {
    "zotero-native-mcp": {
      "command": "npx",
      "args": ["-y", "zotero-native-mcp"]
    }
  }
}

--scope user を指定すると、すべてのプロジェクトに登録されます。指定しない場合、claude mcp add はデフォルトで local スコープとなり、サーバーはコマンドを実行したディレクトリに紐付けられます。そのほかのディレクトリを開くと、ツールは表示されません。

環境変数は必要ありません。新しいセッションを開始してから、接続を確認するため、アシスタントに zotero_status の実行を依頼してください。

ツールが初めて書き込みを行うとき、Zotero に許可を求めるダイアログが表示されます。再度確認されないよう、**「Always Allow」**を選択してください。

ドキュメント

ツール一覧

コレクション：list_collections get_collection create_collection update_collection delete_collection restore_collection

アイテム：search_items get_item get_item_children create_items update_item delete_items restore_items add_items_to_collection remove_items_from_collection get_item_fulltext export_items

ゴミ箱：list_trash empty_trash（および上記の restore_* ツール）

添付ファイル：attach_file get_attachment_path

検索：list_tags list_saved_searches run_saved_search

システム：status authorize list_libraries get_item_type_fields

すべての名前には zotero_ が接頭辞として付きます。完全なシグネチャについては、**リファレンス**をご覧ください。

先行プロジェクト

このプロジェクトはフォークではありません。Zotero 10 でネイティブなローカル書き込みが可能になった後、ゼロから作成されましたが、より厳しい制約のもとで同じ問題を解決した先行プロジェクトの成果を受け継いでいます。

• 54yyyu/zotero-mcp：最も広く利用されている Zotero MCP サーバーです。セマンティック検索など、豊富な機能を備えています。書き込みは api.zotero.org 経由で行われます。
• cookjohn/zotero-mcp：Zotero 内部から MCP エンドポイントを公開する Zotero 7 プラグインで、ベクトル検索にも対応しています。
• Ayanya-0628/zotero-mcp と dzackgarza/zotero-local-write-api：付属の .xpi 書き込みエンドポイントを介したローカル優先の書き込みに対応しています。
• kujenga/zotero-mcp：Zotero API 用の軽量な Python サーバーです。

Zotero 7／8／9 のサポート、セマンティック検索またはベクトル検索、あるいはクラウド経由でしかアクセスできないライブラリへの書き込みが必要な場合は、引き続きこれらのプロジェクトが適しています。

貢献

Issue やプルリクエストを歓迎します。CI は Linux、macOS、Windows で、Node 22、24、26 を使ってすべて成功する必要があります。

開発環境のセットアップ、テストスイート、実際の Zotero に対してすべてのツールを実行するスクリプトについては、CONTRIBUTING を参照してください。

ライセンス

MIT © David Sosa

_{キーワード：Zotero MCP サーバー · Model Context Protocol · Zotero Claude 連携 · Zotero ローカル API · オフライン文献管理自動化 · Zotero AI アシスタント · BibTeX エクスポート · 学術研究ツール · Claude Code Zotero · Cursor Zotero}