mcpbeat Sign in

Zotero MCP Server

local only

Zotero MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 7 146 installs a week from pypi. Last commit 1 Nov 2026.

Search, read, annotate, and add to your Zotero research library, local or web.

Installs per day peak 2 114 · avg 1 120 · +4% w/w
a month agotoday
7 146
Installs / week
pypi · zotero-mcp-server
5 687
Stars
39 open issues
1 Nov 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 1 d ago · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a dangerous call get_item_related.item_key → src/zotero_mcp/cli_standalone.py:1335, get_item_related.item_key → src/zotero_mcp/cli_standalone.py:1339, get_item_related.item_key → src/zotero_mcp/cli_standalone.py:1346 и ещё 7
        subprocess.run(["open", url], check=True)
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

        return os.path.join(base_dir, f"pdfannots2json-{system}-{machine}")
  static async spawn(opts: AcpClientOpts): Promise<AcpClient> {
const AREA_PNG = "iVBORw0KGgoAAAANSUhEUgAAAUAAAAB4CAIAAAAMrLyJAAAI/klEQVR4nO3dbUhT/R/H8d9uFEkTelI9MbiwqJghSmBSRi4rH4hhRHdmRRClbSKB6UaGNVGTgqLQRwUXOgu7+UskmQpSGjofdEOoRDdGCC4LIWxleOb58+9wnWv/M503be18f+fzogfHee42z9vfb9OZ7m3vJgYANOnDfQIAsHAIGIAwo7wUn9IV1jMBgLl650qTFjACAxCGgAEIQ8AAhC…

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add zotero-mcp -- uvx zotero-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.zotero-mcp]
command = "uvx"
args = ["zotero-mcp-server"]
.cursor/mcp.json
{
  "mcpServers": {
    "zotero-mcp": {
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "zotero-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zotero-mcp-server"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: ZOTERO_LOCAL (Read from the local Zotero desktop app instead of the web API. Requires Zotero 7+ with the local API enabled in Settings > Advanced), ZOTERO_API_KEY (Zotero 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_ID (Zotero user or group library ID. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid mode), ZOTERO_LIBRARY_TYPE (Whether ZOTERO_LIBRARY_ID refers to a personal or a group library), ZOTERO_MCP_TOOLSETS (Which 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, named groups (scite, duplicates, discovery, feeds, relations, libraries, search-admin, pdf-geometry) to add them, or a leading '-' to subtract).

Alternatives to Zotero MCP

same job, measured the same way
Zotero MCP Local
by piiinpiiins

Search, read PDFs, and find related papers in your local Zotero library. Read-only, 100% local.

86 installs/wk local only
Drafta
by rpegorov

Search, read and write notes in your local Drafta library over local stdio.

local only
Zotero Native MCP
by dvdsosa

Read and write your local Zotero 10 library. No plugin, no zotero.org API key, no cloud.

260 installs/wk local only
Zotero MCP
by kujenga

Search your Zotero library, retrieve item metadata, and read full text from AI assistants.

1 160 installs/wk local only
Cite Caddy
by herbertkokholm-citecaddy

Remote MCP server for full read/write access to a Zotero library

answering
Sensefold
by sensefold

Personal context for every AI: search, read, and write back to your private Markdown library.

answering
zotio
by orgmentem

Zotero MCP server: local-first search, library checks, and preview-first writes for AI agents.

local only
SourceWeave Web Search
by mrnaqa

Fully local MCP server and CLI for web research

61 installs/wk local only

Zotero MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Zotero MCP?
Zotero MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package zotero-mcp-server was installed 7 146 times last week.
How do I connect Zotero MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls zotero-mcp-server straight from pypi; nothing to host, nothing to sign up for.
How many people use Zotero MCP?
The pypi package zotero-mcp-server was installed 7 146 times in the last week. Week over week that is +4%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Zotero MCP open source?
Yes — it is published under the MIT licence, written in Python, 5 687 stars on GitHub and 39 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.