Zotero Library MCP

An MCP server that lets Claude, Codex, and ChatGPT add papers and books to your Zotero library by DOI, arXiv ID, or ISBN - and manage your collections, tags, and items. Its 36 documented tools cover collection, item, items, tags. It runs locally over stdio via the published package.

People connecting science & health tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-09 · ★ 2 · #41 OF 60 MAINTAINED SCIENCE & HEALTH · VERIFIED 2026-08-25

Python servers · how we verify → /methodology

01 · Install Zotero Library MCP

before you install - you'll need

Set ZOTERO_LIBRARY_ID, ZOTERO_API_KEY, ZOTERO_WEBDAV_URL, ZOTERO_WEBDAV_USER, ZOTERO_WEBDAV_PASSWORD, ZOTERO_MCP_OAUTH_ISSUER, ZOTERO_MCP_OAUTH_RESOURCE, ZOTERO_MCP_OAUTH_JWKS_URL before connecting. ZOTERO_MCP_OAUTH_SCOPES is optional or environment-specific per the README.

Claude Code

claude mcp add raulsimpetru-zotero-library-mcp -- uvx zotero-library-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "raulsimpetru-zotero-library-mcp": {
      "command": "uvx",
      "args": [
        "zotero-library-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license no standard license detected - usage rights unclear; check the repo before commercial use

pypi package zotero-library-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.RaulSimpetru is GitHub-verified and matches the repo owner

03 · What Zotero Library MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can resolve a DOI via CrossRef and add the paper to Zotero (with duplicate detection), add a preprint by arXiv ID (uses DOI when available, falls back to arXiv metadata), create any supported Zotero item type from validated manual metadata, and resolve an ISBN via Open Library and add the book to Zotero (with duplicate detection).

Capability map

Tools grouped from the project's README - what Zotero Library MCP lets an agent do.

read & search

9 tools - e.g. Search your Zotero library by title, author, tag, etc., paginated via start/limit (falls back to fuzzy matching when the exact search returns no results); List recently added items; Get items not in any…

search_library · get_recent_items · get_unfiled_items · search_fulltext · find_duplicates · list_attachments…

Collection

5 tools - e.g. Create a new collection (optionally nested under a parent); Browse items in a collection, paginated via start/limit; Add an existing item to a collection

create_collection · get_collection_items · add_to_collection · remove_from_collection · delete_collection

Item

4 tools - e.g. Create any supported Zotero item type from validated manual metadata; View full metadata for any item; Return bounded plain text from Zotero's index or a PDF, without leaking temporary paths

add_item_from_metadata · get_item_details · get_item_fulltext · delete_item

Tags

4 tools - e.g. List all tags in your library; Add one or more tags to an item (with optional color); Remove tags from an item

list_tags · add_tags · remove_tags · delete_tags

create & write

3 tools - e.g. Batch-add up to 50 papers at once; Resolve an ISBN via Open Library and add the book to Zotero (with duplicate detection); Add a note to an item

add_papers_by_dois · add_book_by_isbn · add_note

Tag

3 tools - e.g. Assign a color to a tag (appears in Zotero's tag selector); Rename a tag across all items in your library; Remove a tag color without deleting the tag

set_tag_color · rename_tag · unset_tag_color

Paper

2 tools - e.g. Resolve a DOI via CrossRef and add the paper to Zotero (with duplicate detection); Add a preprint by arXiv ID (uses DOI when available, falls back to arXiv metadata)

add_paper_by_doi · add_paper_by_arxiv_id

Save

2 tools - e.g. Save an export to an authorized local path; Save a PDF to an authorized local path

save_bibtex · save_pdf

Latest releases

v0.9.0 · 2026-08-09

Migrates the server to the MCP 2.0 Python SDK. Follow-up to the 0.8.3 hotfix, which pinned the SDK to <2 to stop fresh installs from breaking. · Requires mcp[cli]>=2.0.0. Stay on 0.8.3 if you need the 1.x SDK.…

v0.8.3 · 2026-08-09

pin the MCP Python SDK to <2. · The SDK's 2.0.0 release removed mcp.server.fastmcp (replaced by mcp.server.mcpserver). Because the dependency was declared as an unbounded mcp[cli]>=1.26.0, fresh installs resolved to…

v0.8.2 · 2026-07-21

Pagination for large libraries (fixes #2): · get_collection_items and search_library accept a new start offset parameter · Both tools report totals in a footer, e.g. Showing items 101–200 of 566. Pass start=200 to get…

04 · Who maintains Zotero Library MCP

zotero-library-mcp is maintained by raulsimpetru. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

category
science & health - ranked #41 of 60 actively-maintained science & health servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-09)
registry
io.github.RaulSimpetru/zotero-library-mcp (active, first published 2026-03-03 · 16 versions)
packages
pypi:zotero-library-mcp

06 · Zotero Library MCP FAQ

Is Zotero Library MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-09 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Zotero Library MCP do?

With this server connected, an agent can resolve a DOI via CrossRef and add the paper to Zotero (with duplicate detection), add a preprint by arXiv ID (uses DOI when available, falls back to arXiv metadata), create any supported Zotero item type from validated manual metadata, and resolve an ISBN via Open Library and add the book to Zotero (with duplicate detection).

How do I install Zotero Library MCP?

Run `uvx zotero-library-mcp`. The README documents 9 environment variables (ZOTERO_LIBRARY_ID, ZOTERO_API_KEY, ZOTERO_WEBDAV_URL…) to set first. Set ZOTERO_LIBRARY_ID, ZOTERO_API_KEY, ZOTERO_WEBDAV_URL, ZOTERO_WEBDAV_USER, ZOTERO_WEBDAV_PASSWORD, ZOTERO_MCP_OAUTH_ISSUER, ZOTERO_MCP_OAUTH_RESOURCE, ZOTERO_MCP_OAUTH_JWKS_URL before connecting. ZOTERO_MCP_OAUTH_SCOPES is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Zotero Library MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Zotero Library MCP