Skip to main content
Glama

zotero-mcp

A small, read-only MCP server that exposes your Zotero library to Claude (or any MCP client) through Zotero's built-in local HTTP API. No API keys, no cloud — it talks to the Zotero desktop app running on your machine.

What it can do

All tools are read-only:

Tool

Purpose

zotero_search

Search the library (title/creator/year, or everything)

zotero_get_item

Full metadata for one item

zotero_get_children

Notes, attachments, and annotations of an item

zotero_get_item_fulltext

Extracted full text of a PDF/attachment

zotero_list_collections

Browse the collection tree

zotero_collection_items

Items in a collection

zotero_list_tags

List/filter tags

zotero_saved_searches

List saved searches

zotero_export_bibtex

Export items as BibTeX

zotero_export_citation

Formatted citation + bibliography in any CSL style

zotero_health

Check connectivity

Related MCP server: zotero-mcp

Prerequisites

  1. Zotero 7 or newer, running.

  2. Enable the local API: Zotero → Settings → Advanced → "Allow other applications on this computer to communicate with Zotero".

  3. uv installed.

Verify the API is up:

curl 'http://localhost:23119/api/users/0/items?limit=1'

Install & test

cd ~/zotero-mcp
uv sync
uv run pytest          # unit tests (no running Zotero needed)

Smoke-test against your live library (Zotero must be open):

uv run python -c "from zotero_mcp.client import ZoteroLocalClient as C; import json; print(json.dumps(C().search_items(q='', limit=3), default=str)[:600])"

Inspect the tools interactively:

uv run mcp dev src/zotero_mcp/server.py

Register with Claude Code

claude mcp add zotero -- uv --directory ~/zotero-mcp run zotero-mcp

Then ask Claude things like "search my Zotero for papers on diffusion models" or "give me the BibTeX for item ABCD1234".

Configuration

Environment variables (optional):

  • ZOTERO_BASE_URL — override the API base (default http://localhost:23119/api). Useful from WSL where Zotero runs on the Windows host, e.g. http://<windows-host-ip>:23119/api.

  • ZOTERO_USER_ID — override the local user id (default 0; almost always correct).

Notes

  • Read-only by design. Zotero's local API does not support writes; this server intentionally mirrors that. Citation/BibTeX formatting is delegated to Zotero itself.

  • If a tool returns {"error": "Could not reach the Zotero local API..."}, Zotero is closed or the local-API setting is off.

Available Tools

11 tools
zotero_collection_itemsC

List the top-level items in a collection.

Inputs: collection_key (required), limit. Returns: result

zotero_export_bibtexC

Export one or more items as BibTeX (rendered by Zotero).

Inputs: item_keys (required). Returns: result

zotero_export_citationA

Return formatted citation + bibliography HTML for items, in the given CSL style.

Args: item_keys: Items to format. style: A CSL style id, e.g. "apa", "chicago-note-bibliography", "ieee".

Inputs: item_keys (required), style. Returns: result

zotero_get_childrenA

List the notes, attachments, and annotations belonging to an item.

Useful to find the attachment key needed for zotero_get_item_fulltext, or to read a paper's notes.

Inputs: item_key (required). Returns: result

zotero_get_itemA

Get the full metadata for a single item by its key.

Inputs: item_key (required). Returns: object

zotero_get_item_fulltextA

Return the extracted full text for an item.

Accepts either an attachment key directly, or a parent item key (in which case the first attachment with indexed text is used). Full text is only available when Zotero has indexed the attachment.

Inputs: item_key (required). Returns: object

zotero_healthA

Check that the Zotero local API is reachable. Use this to debug connectivity.

Inputs: no named parameters. Returns: object

zotero_list_collectionsA

List collections. Pass a collection key as parent to list its subcollections.

Inputs: parent. Returns: result

zotero_list_tagsA

List tags in the library, optionally filtered by a substring query.

Inputs: limit, query. Returns: result

zotero_saved_searchesA

List the library's saved searches (name + key + conditions).

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: listing, searching, getting metadata/children/fulltext, exporting in different formats, checking health, and listing collections/tags/saved searches. No overlapping functionality that would cause confusion.

    Naming Consistency4/5

    All tools share the 'zotero_' prefix and mostly follow a verb_noun pattern (e.g., zotero_get_item, zotero_search, zotero_list_collections). Minor deviations: 'zotero_collection_items' and 'zotero_saved_searches' are noun phrases rather than explicit verbs, but still clear.

    Tool Count5/5

    11 tools is well-scoped for a research reference management server. Each tool serves a necessary function without redundancy, covering search, retrieval, listing, export, and health checks.

    Completeness4/5

    The tool set provides thorough read capabilities: search, get items/fulltext/children, list collections/tags/saved searches, and export. It lacks create/update/delete operations, but the server appears designed for querying and exporting, so the surface is appropriate for that purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers