54yyyu /zotero-mcp
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.
★ 5,925⑂ 467👁 13⑃ 476● 353▤ 40
+9
Daily
5,925
stars
467
forks
13
watchers
476
prs
353
issues
40
releases
README
Zotero MCP: Chat with your Research Library in Claude, ChatGPT, and more
Your Zotero library, in every AI agent.
Search, read, cite and annotate your papers from Claude, ChatGPT, Codex, Cursor, or a chat panel inside Zotero.
Install ·
Docs ·
Zotero Agent ·
Discord
Zotero Agent explaining a paper with page citations. A click on a citation opens the page and flashes the cited sentence.
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-cli + agent skill | 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 | zotero-mcp setup | zotero-mcp install-skill | zotero-cli plugin, then install the .xpi in Zotero |
| 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 | Getting started | CLI and agent skill | Zotero Agent plugin |
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 API
- Scite citation tallies and retraction alerts (optional)
Quick start
1. Install (Python 3.10+):
bash
uv tool install zotero-mcp-server or: pip install zotero-mcp-server
New 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:
Claude Desktop
bash
zotero-mcp setup auto-configures Claude Desktop
or add the server by hand to claude_desktop_config.json:
json
{
"mcpServers": {
"zotero": {
"command": "zotero-mcp",
"env"Top issues
#377Feature request: rename an attachment's filename on disk, not just its title5 comments · 2026-07-11#604`update-db` without `--fulltext` indexes every annotation, the SQLite path does not, and the mismatch never self-heals4 comments · 2026-09-25#493Feature request: dedupe cross-library copies in semantic search results (with over-fetch so limit stays meaningful)4 comments · 2026-08-24#46Feature request: batch processing support for Systematic Literature Reviews (SLRs)4 comments · 2025-08-11#826Proposal: Decouple passage chunks from items by keying passages to attachment_key (#494, #495)3 comments · 2026-11-11#591Attachment file helpers don't know which library they serve — group uploads go to the personal WebDAV3 comments · 2026-09-24#563 classify_pdf() raises "Invalid PDF structure" on a CNKI-produced PDF while PyMuPDF reads it fine (v1.20.0)3 comments · 2026-09-17#399PDF attach silently fails on free-tier cloud quota (HTTP 413) for local-storage users without WebDAV — propose connector-endpoint fallback3 comments · 2026-07-24
Discussions
#460Is there a way to limit semantic search to a subset of our whole library?1 comments · 2026-08-17#407Compatibility with milvus and pgvector0 comments · 2026-07-28#288zotero-cli - How to install1 comments · 2026-05-20#251Gemini CLI / Claude Desktop x Zotero MCP Remote Setup0 comments · 2026-04-22#186Zotero MCP Differences0 comments · 2026-03-26#184Multiple group libraries1 comments · 2026-03-26#176Is Codex App able to access this MCP?0 comments · 2026-03-24#150Is it possible to add support for exporting bibtex reference?0 comments · 2026-03-15
Latest release
v0.17.2 v0.17.2 2026-11-15What's Changed chore(plugin): updates.json for 0.17.1 by @54yyyu in https://github.com/54yyyu/zotero-mcp/pull/830 test: migration tests start each run like a fresh process (Windows flake) by @54yyyu in https://github.com/54yyyu/zotero-mcp/pull/831 Release 0.17.2 by @54yyyu in https://github.com/54yyyu/zotero-mcp/pull/848 fix(embeddings): add ZOTERO_ONNX_THREADS for the default model's ONNX Runtime thread count (90) by @lots-o in https://github.com/54yyyu/zotero-mcp/pull/828 feat(plugin): 支持自动总结、论文标题等多种方式命名对话,并支持手动改名 by @HelloNVIC in https://github.com/54yyyu/zotero-mcp/pull/836 feat(plug