by 54yyyu
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.
# Add to your Claude Code skills
git clone https://github.com/54yyyu/zotero-mcpGuides for using ai agents skills like zotero-mcp.
Last scanned: 10/7/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-07T10:51:33.714Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how zotero-mcp compares with popular alternatives.
zotero-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by 54yyyu. 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. It has 6,009 GitHub stars.
Yes. zotero-mcp passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/54yyyu/zotero-mcp" and add it to your Claude Code skills directory (see the Installation section above).
zotero-mcp is primarily written in Python. It is open-source under 54yyyu on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh zotero-mcp against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
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.
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 |
zotero.sqlite; writes go to the running Zotero 10+ or through the web API1. Install (Python 3.10+):
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:
zotero-mcp setup # auto-configures Claude Desktop
or 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-skill
Or 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 it
Then 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".
The base install covers search, reading, annotations, and writes. Heavier features are extras:
| Extra | What it adds | Install command |
|---|---|---|
semantic |
Semantic search via ChromaDB, sentence-transformers, OpenAI/Gemini embeddings | pip install "zotero-mcp-server[semantic]" |
pdf |
PDF outlines, page layout and page images (PyMuPDF), EPUB annotations | pip install "zotero-mcp-server[pdf]" |
scite |
Scite citation tallies and retraction alerts (no account needed) | pip install "zotero-mcp-server[scite]" |
all |
Everything above | pip install "zotero-mcp-server[all]" |
Update any time with zotero-mcp update.
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-skill
An 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,752 | every request |
| MCP server, all tools (51) | 10,971 | every request |
| Agent skill, frontmatter only | 98 | always |
| Agent skill, body loaded | 2,755 | when it fires |
| Agent skill + full command reference | 7,944 | only if the agent opens it |
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.
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.