Zotero MCP
Search, read, annotate and add to your Zotero library from AI assistants
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.17.2
- Listing updated
- 3 days ago
About Zotero MCP
Zotero MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Zotero MCP reads your Zotero library either from the desktop app's local API (Zotero 7 or newer, with the local API enabled) or through the web API. It ships three routes in one Python package: an MCP server for chat apps, a zotero-cli with an installable agent skill for assistants with a shell, and a Zotero Agent chat panel that sits next to the PDF you are reading.
Search works by title, author, tag, collection, full text or meaning, using local, OpenAI, Gemini or Ollama embeddings. It can read metadata, BibTeX, full text and PDF page ranges, place highlights and area boxes on exact words or figures, add papers by DOI, URL, ISBN, BibTeX or file, manage collections and tags, and merge duplicates. Scite citation tallies and retraction alerts are optional.
Optional tool groups are off by default because every tool is sent to the model on each request; the changelog says default tools now cost about 8k tokens per request. Writes go to a running Zotero or through the web API with a key.
Install
Run in a terminal
claude mcp add zotero-mcp --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- uvx zotero-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"zotero-mcp": {
"command": "uvx",
"args": [
"zotero-mcp-server"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"zotero-mcp": {
"command": "uvx",
"args": [
"zotero-mcp-server"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"zotero-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zotero-mcp-server"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"zotero-mcp": {
"command": "uvx",
"args": [
"zotero-mcp-server"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"zotero-mcp": {
"command": "uvx",
"args": [
"zotero-mcp-server"
],
"env": {
"ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
}
}
}
}Configuration
ZOTERO_LOCALRead from the local Zotero desktop app instead of the web API. Requires Zotero 7+ with the local API enabled in Settings > Advanced.ZOTERO_API_KEYZotero Web API key from https://www.zotero.org/settings/keys. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid mode.ZOTERO_LIBRARY_IDZotero user or group library ID. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid mode.ZOTERO_LIBRARY_TYPEWhether ZOTERO_LIBRARY_ID refers to a personal or a group library.ZOTERO_MCP_TOOLSETSWhich optional tool groups to expose, as a comma-separated list. Every tool is sent to the model on each request, so optional capabilities are off by default. Use 'all' for the full surface, 'none' for core only, 'default' for the default profile, named groups (scite, duplicates, discovery, feeds, relations, libraries, search-admin, pdf-geometry, legacy) to add them, or a leading '-' to subtract. 'legacy' brings back tool names merged in 0.16 (until 0.17).
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- zotero_semantic_search
- Finds papers conceptually similar to a query, at article or passage level.
- zotero_get_annotations
- Extracts PDF annotations from a paper.
- zotero_get_item_metadata
- Returns item metadata, including BibTeX.
- zotero_add_item
- Adds an item by DOI to chosen collections.
What it does
- Semantic search
- Find papers by meaning using local, OpenAI, Gemini or Ollama embeddings.
- Precise annotations
- Place highlights and area boxes on exact words, figures or equations.
- Add by identifier
- Import items by DOI, URL, ISBN, BibTeX or file.
- Local or web
- Read from zotero.sqlite locally or use the Zotero web API.
- CLI and agent skill
- A cheaper route for agents that have a shell.
- In-Zotero chat panel
- Zotero Agent runs beside the PDF you are reading.
Good for
- Find papers similar to a topic in your library
- Pull highlights from a PDF
- Export BibTeX for a set of papers
- Add a DOI to a Reading List collection
- Merge duplicate items
Pricing
Open source
Free; paid embedding providers bill separately if used
Prices change. Check stevenyuyy.com before you buy.
Zotero MCP FAQ
Do I need the web API?
Not for local mode; it is needed when ZOTERO_LOCAL is false or for writes in hybrid mode.
What Python version?
Python 3.10 or newer.
How is it installed?
uv tool install zotero-mcp-server, pip, pipx or Docker, then zotero-mcp setup.
Why are some tools off?
Every tool is sent to the model on each request, so optional groups are off by default.
Is Zotero MCP free?
Yes. Zotero MCP is open source, so you can use and self-host it for free.
How do I add Zotero MCP to Claude Code?
Run this command in your terminal: claude mcp add zotero-mcp --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- uvx zotero-mcp-server
What are the best alternatives to Zotero MCP?
The closest alternatives to Zotero MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Zotero MCP

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents