Zotero MCP

Zotero MCP：Claude、ChatGPT などで研究ライブラリと対話

あらゆる AI エージェントで Zotero ライブラリを活用できます。
Claude、ChatGPT、Codex、Cursor、または Zotero 内のチャットパネルから、論文の検索、閲覧、引用、注釈の追加ができます。

インストール · ドキュメント · Zotero エージェント · Discord

_{ページ引用を示しながら論文を説明する Zotero Agent。引用をクリックすると該当ページが開き、引用された文が一瞬ハイライト表示されます。}

Zotero MCP は、Model Context Protocol を介して、研究ライブラリの Zotero と ChatGPT、Claude、その他の AI アシスタント（例：Cherry Studio、Chorus、Cursor）を連携します。ライブラリを検索し、論文を閲覧して注釈を追加したり、アイテムを追加・整理したり、意味に基づいて研究を探したりできます。

AI エージェント： まず docs/for-agents.md をお読みください。利用する方法、セットアップ、コマンドをまとめて説明しています。

3つの利用方法

zotero-mcp-server という1つのパッケージで、3つすべてを利用できます。普段の作業に合ったものを選んでください。

できること

• 検索：タイトル、著者、タグ、コレクション、全文、意味で検索できます（ローカル、OpenAI、Gemini、Ollama の埋め込みを使ったセマンティック検索）
• 読み取り：メタデータ、BibTeX、全文、PDF のページ範囲を読み取れます。テキスト抽出で数式、図、表が崩れる場合はページ画像も利用できます
• 注釈：正確な語句、図、表、数式にハイライトや領域ボックスを配置できます。ノートの追加、PDF 注釈の抽出もできます
• 書き込み：DOI、URL、ISBN、BibTeX、ファイルから論文を追加できます（オープンアクセスの PDF にも対応）。コレクションやタグの管理、重複項目の統合もできます
• ローカルまたはウェブ：ローカルモードでは zotero.sqlite から直接読み取ります。書き込みは、起動中の Zotero 10+ に対して行うか、ウェブ API 経由で行います
• Scite の引用数と撤回アラート（オプション）

クイックスタート

1. インストール（Python 3.10+）：

uv tool install zotero-mcp-server     # or: pip install zotero-mcp-server

コマンドラインを初めて使いますか？ コミュニティが開発した Zotero MCP Setup をお試しください。macOS 用 GUI インストーラー、Mac と Windows 用のワンクリックスクリプト、手順を追ったガイドが用意されています。

2. Zotero のローカル API を有効にする：Zotero 7+ で、設定 → 詳細を開き、このコンピューター上の他のアプリケーションが Zotero と通信することを許可するにチェックを入れます。

3. アシスタントに接続する：

zotero-mcp setup      # auto-configures Claude Desktop

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": { "ZOTERO_LOCAL": "true" }
    }
  }
}

zotero-mcp install-skill

zotero-cli plugin     # where the .xpi is, and how to install it

4. 書き込み（オプション）：Zotero 10+ では、zotero-mcp authorize-local を一度実行し、常に許可を選択します。古いバージョンの Zotero では、ウェブ API 経由で書き込むために ZOTERO_API_KEY と ZOTERO_LIBRARY_ID を追加します。

次のように質問してみてください。「ライブラリから注意機構に関する論文を探して」、「この論文の主な知見を要約して」、「この PDF の主張にハイライトを付けて」。

オプションの追加機能

基本のインストールには、検索、閲覧、注釈、書き込みが含まれます。より高度な機能は追加オプションです。

zotero-mcp update でいつでも更新できます。

MCP サーバーとエージェントスキルのどちらを使うべきですか？

エージェントがシェルを使える場合（Claude Code、Cursor、Codex、Windsurf、Gemini CLI、Amp、OpenCode など）は、1 つのコマンドで zotero-cli の使い方を教えられます。

zotero-mcp install-skill

MCP サーバーは、何かを入力する前に、すべてのリクエストで各ツールのスキーマを送信します。スキルのコストは、エージェントが関連すると判断するまで 98 トークンです。

クライアントが MCP に対応していてもシェルを使えない場合（Claude Desktop、ChatGPT）は MCP サーバーを、シェルを使える場合はスキルを使用してください。どちらも同じ設定を共有します。詳しくは、CLI とエージェントスキルをご覧ください。

Zotero Agent：Zotero 内でチャット

Zotero 自体にチャットパネルを追加するプラグインで、ユーザー自身の Claude Code、Codex、または pi を使用します。開いているアイテムとページを把握し、zotero-cli を使ってライブラリを操作します。回答では実際の zotero:// リンクで論文を引用するため、クリックするとそのページの PDF が開きます。wheel に同梱されています。ファイルとインストール手順を取得するには zotero-cli plugin を実行するか、ドキュメントにある 1 段落のプロンプトをエージェントに貼り付けて、セットアップを任せてください。詳しくは、Zotero Agent プラグインをご覧ください。

ウェブサイト：stevenyuyy.com/zotero-mcp · 変更履歴

コントリビューション

イシューやプルリクエストを歓迎します。uv run pytest tests/ でテストを実行してください。実際のライブラリに対して Claude が実行することを想定したライブ統合テスト計画は、docs/integration-test-plan.md にあります。plugin/ 内のプラグイン（AGPL-3.0）への変更は、メンテナーが商用利用を含む他の条件でもリリースできることを条件として受け付けます。

Zotero MCP にコード、修正、アイデアを提供してくださった皆さまに感謝します。

サポート

Zotero MCP は無料のオープンソースソフトウェアです。

ご自身や研究室の時間を節約できた場合、スポンサーになることで、Windows や WSL2 の扱いにくいエッジケース、Zotero のスキーマ変更、グループライブラリのサポート、埋め込み／検索インフラなど、目立たない作業を支援できます。

研究室および機関向け： 50 ドルと 200 ドルのティアは経費として計上できるよう設定されており、ワークフローに影響するイシューの優先的なトリアージが含まれます。

ライセンス

MCP サーバーと zotero-cli は MIT ライセンスです（LICENSE）。plugin/ の Zotero Agent プラグインは AGPL-3.0-or-later ライセンスです（plugin/LICENSE。これは Zotero 自体が採用しているライセンスです。