Local Zotero MCP server

Zotero MCP Claude | Codex

A read-only local MCP wrapper for Zotero that lets Claude Desktop and Codex search your research library, notes, tags, collections, fulltext index, and markdown or text attachments without Gemini, API keys, or Zotero Web API access.

What it does

Local Zotero search

Search Zotero metadata, authors, tags, collections, and exact fulltext-index hits from your computer.

Notes and attachments

Read Zotero notes as cleaned text and access markdown, plain text, and other text attachments safely.

No external AI service

No Gemini, no embeddings, no Zotero Web API key, and no network calls from the MCP server.

How to install

  1. Install Zotero Desktop and make sure your library exists locally on your computer.
  2. Download this project and put it somewhere stable, such as /Users/your-name/Applications/.
  3. Open Terminal in the project folder.
  4. Run python3 --version to confirm Python is available.
  5. Run ./smoke-test.sh to check that the wrapper can read your Zotero database.
  6. Run pwd and add /run-zotero-mcp.sh to the end of the printed path.
  7. Add that launcher path to your Claude Desktop or Codex MCP config.
  8. Restart Claude Desktop or Codex.

MCP config

MCP tools

Try it in chat