The Zotero MCP server is a tool server based on the Model Context Protocol that provides seamless integration with the Zotero reference management system for AI applications like Claude Desktop. Through this server, AI assistants can:
How to install zotero-mcp?
cookjohn/zotero-mcp
$git clone https://github.com/cookjohn/zotero-mcpInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install zotero-mcp by running `git clone https://github.com/cookjohn/zotero-mcp`, then use it for the current task and follow its documentation at https://github.com/cookjohn/zotero-mcp.
README.md
| 1 | # Zotero MCP - Model Context Protocol Integration for Zotero |
| 2 | |
| 3 | Zotero MCP is an open-source project designed to seamlessly integrate powerful AI capabilities with the leading reference management tool, Zotero, through the Model Context Protocol (MCP). This project consists of two core components: a Zotero plugin and an MCP server, which work together to provide AI assistants (like Claude) with the ability to interact with your local Zotero library. |
| 4 | _This README is also available in: [:cn: 简体中文](./README-zh.md) | :gb: English._ |
| 5 | [](https://github.com/cookjohn/zotero-mcp) |
| 6 | [](https://www.zotero.org) |
| 7 | [](https://nodejs.org) |
| 8 | [](https://www.typescriptlang.org) |
| 9 | []() |
| 10 | [](README.md) |
| 11 | [](README-zh.md) |
| 12 | |
| 13 | --- |
| 14 | ## Fork us on Wechat |
| 15 | | MP | Forum | |
| 16 | | :--- | :---: | |
| 17 | |  |  | |
| 18 | ## 📚 Project Overview |
| 19 | |
| 20 | The Zotero MCP server is a tool server based on the Model Context Protocol that provides seamless integration with the Zotero reference management system for AI applications like Claude Desktop. Through this server, AI assistants can: |
| 21 | |
| 22 | - 🔍 **Smart Search**: Multi-dimensional library search (title/creator/year/tags/fulltext/semantic) with boolean operators and relevance scoring |
| 23 | - 📖 **Content Extraction**: Extract PDF full-text, notes, abstracts, webpage snapshots with fine-grained mode control |
| 24 | - 📝 **Annotation Analysis**: Search and analyze PDF highlights and annotations by color, tags, and keywords |
| 25 | - 📂 **Collection Browsing**: Browse and search collection hierarchies, retrieve items within collections |
| 26 | - 🧠 **Semantic Search**: AI-powered concept matching via embedding vectors, discover related literature across languages |
| 27 | - ✏️ **Write Operations**: Create notes, manage tags, update metadata, create new items and attach PDFs |
| 28 | - 💾 **Full-text Database**: Access and search cached PDF full-text content |
| 29 | |
| 30 | This enables AI assistants to help you with literature reviews, citation management, content analysis, annotation organization, knowledge base management, and more. |
| 31 | |
| 32 | ## 🚀 Project Structure |
| 33 | |
| 34 | This project now features a **unified architecture** with an integrated MCP server: |
| 35 | |
| 36 | - **`zotero-mcp-plugin/`**: A Zotero plugin with **integrated MCP server** that communicates directly with AI clients via Streamable HTTP protocol |
| 37 | - **`IMG/`**: Screenshots and documentation images |
| 38 | - **`README.md`** / **`README-zh.md`**: Documentation files |
| 39 | |
| 40 | **Unified Architecture:** |
| 41 | ``` |
| 42 | AI Client ↔ Streamable HTTP ↔ Zotero Plugin (with integrated MCP server) |
| 43 | ``` |
| 44 | |
| 45 | This eliminates the need for a separate MCP server process, providing a more streamlined and efficient integration. |
| 46 | |
| 47 | --- |
| 48 | |
| 49 | ## 🚀 Quick Start Guide |
| 50 | |
| 51 | This guide is intended to help general users quickly configure and use Zotero MCP, enabling your AI assistant to work seamlessly with your Zotero library. |
| 52 | |
| 53 | ### 1. Installation (For General Users) |
| 54 | |
| 55 | **What is Zotero MCP?** |
| 56 | |
| 57 | Simply put, Zotero MCP is a bridge connecting your AI client (like Cherry Studio, Gemini CLI, Claude Desktop, etc.) and your local Zotero reference management software. It allows your AI assistant to directly search, query, and cite references from your Zotero library, greatly enhancing academic research and writing efficiency. |
| 58 | |
| 59 | **Two-Step Quick Start:** |
| 60 | |
| 61 | 1. **Install the Plugin**: |
| 62 | * Go to the project's [Releases Page](https://github.com/cookjohn/zotero-mcp/releases) to download the latest `zotero-mcp-plugin-x.x.x.xpi` file. |
| 63 | * In Zotero, install the `.xpi` file via `Tools -> Add-ons`. |
| 64 | * Restart Zotero. |
Related
6 picksType
- Context7Up-to-date library docs injected straight into your promptstoday
- repomixA tool to pack repository contents to single file for AI consumptionJul 2026
- markitdown-mcpA Model Context Protocol server for converting documents to Markdown using MarkItDownJun 2026
- anytype-mcpOfficial MCP server for Anytype API - your encrypted, local and collaborative wiki.Jul 2026
- mcp-server-atlassian-confluenceNode.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.Feb 2026
- obsidian-mcp-server-enhancedThis is an enhanced version of the excellent cyanheads/obsidian-mcp-server with additional features specifically tailored for remote Claude.ai integration, advanced task querying, and security via Tailscale.Jul 2026
