Zotero MCP
Provides tools for interacting with a Zotero research library: searching items by title, author, tag, collection, full text, or semantic meaning; reading metadata, BibTeX, full text, and PDF page ranges; creating annotations and notes; adding papers by DOI, URL, ISBN, BibTeX, or file; and managing collections, tags, and duplicates.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ο»Ώ# π Zotero Mcp
Official Open-Source Release & Maintained Codebase by @kush-coder

π‘ About This Project
Zotero MCP: Connects your Zotero research library with Claude and other AI assistants via the Model Context Protocol to discuss papers, get summaries, analyze citations, and more.
This repository is actively maintained and distributed by @kush-coder as an official open-source release.
Related MCP server: zotero-mcp-plus
β¨ Key Highlights
π‘οΈ Verified Health Checks: Passed automated sandbox builds, dependency resolution, and health test runs.
π Production Ready: Lightweight footprint optimized for high efficiency.
π¦ Permissive Open Source: Available for developer integration, custom modifications, and community enhancements.
π Quick Start & Installation
# Clone your official repository
git clone https://github.com/kush-coder/autopilot-zotero-mcp.git
cd autopilot-zotero-mcpπ Comprehensive Documentation
Zotero MCP connects your Zotero research library with ChatGPT, Claude, and other AI assistants (e.g., Cherry Studio, Chorus, Cursor) via the Model Context Protocol. Search your library, read and annotate papers, add and organize items, and find research by meaning.
AI agents: read docs/for-agents.md first. It covers which route to use, setup, and the commands in one place.
Three ways in
One package, zotero-mcp-server, ships all three. Pick the one that fits where you work.
MCP server |
| Zotero Agent | |
For | Chat apps that speak MCP but have no shell: Claude Desktop, ChatGPT, Cherry Studio, Chorus | Agents with a shell: Claude Code, Codex, Cursor, Windsurf, Gemini CLI, Amp, OpenCode | Chatting inside Zotero, next to the PDF you are reading |
How |
|
|
|
Why | Works in any MCP client | 98 tokens in context until it is needed, instead of ~8k | Knows the item, page and selection you have open; answers link to pages |
Guide |
What it does
Search by title, author, tag, collection, full text, or meaning (semantic search with local, OpenAI, Gemini, or Ollama embeddings)
Read metadata, BibTeX, full text, and page ranges of PDFs, with page images where text extraction garbles math, figures, and tables
Annotate: highlights and area boxes placed on the exact words, figure, table, or equation; notes; PDF annotation extraction
Write: add papers by DOI, URL, ISBN, BibTeX, or file (with open-access PDFs), manage collections and tags, merge duplicates
Local or web: in local mode reads come straight from
zotero.sqlite; writes go to the running Zotero 10+ or through the web APIScite citation tallies and retraction alerts (optional)
Quick start
1. Install (Python 3.10+):
uv tool install zotero-mcp-server # or: pip install zotero-mcp-serverNew to the command line? Try the community-built Zotero MCP Setup: a macOS GUI installer, one-click scripts for Mac and Windows, and a step-by-step guide.
2. Enable Zotero's local API: in Zotero 7+, open Settings β Advanced and tick Allow other applications on this computer to communicate with Zotero.
3. Connect your assistant:
zotero-mcp setup # auto-configures Claude Desktopor add the server by hand to claude_desktop_config.json:
{
"mcpServers": {
"zotero": {
"command": "zotero-mcp",
"env": { "ZOTERO_LOCAL": "true" }
}
}
}Teach the agent to drive zotero-cli (the cheaper route, see below):
zotero-mcp install-skillOr use the MCP server: for Claude Code, add the same mcpServers entry as above to ~/.claude.json.
See Getting started.
zotero-cli plugin # where the .xpi is, and how to install itThen in Zotero: Tools > Plugins, the gear, Install Plugin From File. Details: Zotero Agent plugin.
4. Writes (optional): on Zotero 10+, run zotero-mcp authorize-local once and choose Always Allow. On older Zotero, add ZOTERO_API_KEY and ZOTERO_LIBRARY_ID to write through the web API.
Then ask things like "Find papers in my library on attention mechanisms", "Summarize the key findings of this paper", or "Highlight the main claims of this PDF".
Optional extras
The base install covers search, reading, annotations, and writes. Heavier features are extras:
Extra | What it adds | Install command |
| Semantic search via ChromaDB, sentence-transformers, OpenAI/Gemini embeddings |
|
| PDF outlines, page layout and page images (PyMuPDF), EPUB annotations |
|
| Scite citation tallies and retraction alerts (no account needed) |
|
| Everything above |
|
Update any time with zotero-mcp update.
MCP server or agent skill?
If your agent has a shell (Claude Code, Cursor, Codex, Windsurf, Gemini CLI, Amp, OpenCode β¦), one command teaches it to drive zotero-cli:
zotero-mcp install-skillAn MCP server sends every tool's schema on every request, before you type anything. The skill costs 98 tokens until the agent decides it is relevant:
Route | In context | Paid |
MCP server, default profile (38 tools) | 7,939 | every request |
MCP server, all tools (50) | 11,225 | every request |
Agent skill, frontmatter only | 98 | always |
Agent skill, body loaded | 2,400 | when it fires |
Agent skill + full command reference | 6,582 | worst case |
Use the MCP server when your client speaks MCP but has no shell (Claude Desktop, ChatGPT); use the skill when it has a shell. Both share one config. Details: CLI and agent skill.
Zotero Agent: chat inside Zotero
A plugin that adds a chat panel to Zotero itself, driven by your own Claude Code, Codex, pi or OpenCode. It knows which item and page you have open and works your library through zotero-cli. Answers cite papers with real zotero:// links, so a click opens the PDF at that page. It ships in the wheel: run zotero-cli plugin for the file and the install steps, or paste the one-paragraph prompt in the docs to your agent and let it do the setup. Details: Zotero Agent plugin.
Documentation
Guide | What's in it |
Connecting Claude Desktop and Claude Code, VS Code / GitHub Copilot, ChatGPT, Cherry Studio, Chorus, Autohand, and other MCP clients | |
Environment variables, local writes, web and hybrid modes, the SQLite read backend, global search, text extraction, command-line options | |
Embedding models, building and updating the index | |
Every MCP tool, tool groups ( | |
| |
The chat panel inside Zotero: install, first run, agents and sign-in, privacy | |
Container images and runtime modes | |
Common problems and fixes | |
One guide for an agent setting up or using Zotero MCP |
Website: stevenyuyy.com/zotero-mcp Β· Changelog
Contributing
Issues and pull requests are welcome. Run the tests with uv run pytest tests/. A live integration test plan, meant to be run by Claude against a real library, is in docs/integration-test-plan.md. Changes to the plugin in plugin/ (AGPL-3.0) are accepted on the condition that the maintainer may also release them under other terms, including commercial ones.
Thanks to everyone who has contributed code, fixes, and ideas to Zotero MCP.
Support
Zotero MCP is free and open source.
If it saves you or your lab time, sponsoring helps cover the unglamorous parts: Windows and WSL2 edge cases, Zotero schema changes, group-library support, and the embedding/search infrastructure.
Labs and institutions: the $50 and $200 tiers are meant to be expensable, and include priority triage on the issues affecting your workflow.
License
The MCP server and zotero-cli are MIT (LICENSE). The Zotero Agent plugin in plugin/ is AGPL-3.0-or-later (plugin/LICENSE), the license Zotero itself uses.
Maintained with β€οΈ by @kush-coder. Official distribution powered by GitHub Autopilot Automation Platform.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
Academic literature search, retrieval, and private library management on top of OpenAlex.
Personal context for every AI: search, read, and write back to your private Markdown library.
Search, organize, and chat with your saved Reddit posts from Claude, Cursor, and any MCP client.
Related MCP Servers
- AlicenseAqualityBmaintenanceConnects your Zotero research library with Claude and other AI assistants via the Model Context Protocol, allowing you to search your library, access content, discuss papers, get summaries, and analyze citations.358,531 PyPI5,915MIT
- AlicenseNot gradedqualityDmaintenanceConnects your Zotero research library with AI assistants (Claude, ChatGPT, etc.) via the Model Context Protocol, enabling paper review, summaries, annotations, and semantic search both locally and through the web API.MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search a Zotero library, retrieve complete item metadata, and access full text from stored PDFs through the Model Context Protocol.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search a Zotero library, retrieve complete item metadata, and fetch full text from attached documents such as PDFs through the Model Context Protocol.-