Skip to content
MCP server

Zotero MCP

Search, read, annotate and add to your Zotero library from AI assistants

Runs locallyStatus and history
Install
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-server

Add 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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Local-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
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  6. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents