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
PythonMITCreated 2025-03-22stevenyuyy.com/zotero-mcp/
Download: v0.17.2v0.17.2 ↓0.17.22026-11-15
+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

Discussions

Latest release

v0.17.2 v0.17.2 2026-11-15
What'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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON