# Zotero MCP

> Zotero MCP is an open-source MCP server for knowledge and memory. Search, read, annotate and add to your Zotero library from AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, self-hosted
- **Website:** https://stevenyuyy.com/zotero-mcp/
- **Repository:** https://github.com/54yyyu/zotero-mcp
- **MCP Registry name:** io.github.54yyyu/zotero-mcp
- **Categories:** knowledge and memory, files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add zotero-mcp --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- uvx zotero-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zotero-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/zotero-mcp
