Skip to main content
Glama
Zotero MCP

Zotero MCP

by 404Simon

Zotero MCP

Schreibgeschützter MCP-Server für deine lokale Zotero-Bibliothek. Durchsucht Sammlungen, prüft Paper-Metadaten und extrahiert Volltexte aus PDFs – alles über FastMCP-Tools.

Voraussetzungen

  • Zotero-Desktop, synchronisiert mit ~/Zotero/zotero.sqlite (Standard unter Linux)

  • Python 3.13+

  • uv

Related MCP server: zotero-mcp

Konfiguration

Dies ist ein MCP-Server. Du registrierst ihn in der MCP-Konfiguration deines Coding-Agenten, und der Agent kann seine Tools dann nutzen.

Die meisten Coding-Agenten akzeptieren eine ähnliche Konfiguration. In Opencode fügst du sie beispielsweise zur opencode.json hinzu:

{
  "mcp": {
    "zotero-mcp": {
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/404Simon/zotero-mcp",
        "zotero-mcp"
      ],
      "enabled": true,
      "type": "local"
    }
  }
}

Nach diesem Setup erkennt der Agent die Tools automatisch, und du kannst ihn einfach Dinge fragen wie:

„Welche Papers zum Thema RAG habe ich in meiner Bibliothek, und wie lautet das Abstract des neuesten?"

Tools

list_library

Listet alle Sammlungen und Papers als formatierte Baumstruktur auf. Optional kann nach Sammlungsname, Paper-Titel oder Autor gefiltert werden.

Argument

Typ

Beschreibung

query

string (optional)

Filtert nach Sammlungsname, Paper-Titel oder Autor (Groß-/Kleinschreibung wird ignoriert)

Jede Paper-Zeile enthält den Item-Schlüssel in eckigen Klammern [KEY]. Verwende diesen Schlüssel mit paper_details oder paper_text. Gefilterte Ausgaben zeigen nur den passenden Teilbaum mit den übereinstimmenden Sammlungen und ihren übergeordneten Sammlungen.

├── AI (2 papers)
│     [N3G6XKB9] [preprint] Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks (2021) - Patrick Lewis
│     [PPJJCMXJ] [book] Grundkurs Künstliche Intelligenz: eine praxisorientierte Einführung (2021) - Wolfgang Ertel
├── Bachelorarbeit (42 papers)
│   ├── GraalVM (4 papers)
│   │     [DSUERN67] [book] Supercharge your applications with GraalVM ... (2021) - A. B. Vijay Kumar
│   └── Java Performance (1 papers)
│         [Q3ANMGC3] [conferencePaper] Applying Optimizations for Dynamically-typed Languages to Java (2017) - Matthias Grimmer
│   [MTSF327R] [book] Pro Spring Boot 3: An Authoritative Guide with Best Practices (2024) - Felipe Gutierrez
├── Studienarbeit (49 papers)
│     [T3ZCDWC7] [preprint] MMLU-Pro: A More Robust and Challenging Multi-Task Language Understanding Benchmark (2024) - Yubo Wang
├── T3000 (4 papers)
│     [DTZF77Y4] [webpage] Conventional Commits (n.d.) - Unknown
├── TheGreenEpoch (8 papers)
│     [YINRQ63P] [preprint] Distributed LLM Pretraining During Renewable Curtailment Windows (2026) - Philipp Wiesner
└── VesSkel (19 papers)
      [ZUXQUGHW] [journalArticle] Open-source analysis and visualization of segmented vasculature datasets with VesselVio (2022) - Jacob R. Bumgarner

paper_details

Ruft vollständige Metadaten eines Papers anhand seines Item-Schlüssels ab. Du erhältst den Schlüssel aus der list_library-Ausgabe (angezeigt als [KEY]) oder aus den search_papers-Ergebnissen.

Argument

Typ

Beschreibung

item_key

string (required)

Zotero-Item-Schlüssel (angezeigt als [KEY] in list_library-Ausgabe oder in search_papers-Ergebnissen)

Gibt Titel, Typ, Schlüssel, Hinzufügungs-/Änderungsdaten, Autoren, alle Feldmetadaten, Sammlungszugehörigkeiten und Informationen zu PDF-Anhängen zurück:

Title: MMLU-Pro: A More Robust and Challenging Multi-Task Language Understanding Benchmark
Type: preprint
Key: T3ZCDWC7
Authors: Yubo Wang, Xueguang Ma, Ge Zhang, Yuansheng Ni, ...
date: 2024-11-06
DOI: 10.48550/arXiv.2406.01574
url: http://arxiv.org/abs/2406.01574
abstractNote: In the age of large-scale language models, benchmarks like the Massive Multitask Language Understanding (MMLU) ...
Collections: Studienarbeit
PDF: Wang et al. - 2024 - MMLU-Pro A More Robust and Challenging Multi-Task Language Understanding Benchmark.pdf

search_papers

Durchsucht alle Papers nach Titel oder Autor. Gibt strukturierte Ergebnisse mit Item-Schlüsseln zurück.

Argument

Typ

Beschreibung

query

string (required)

Suchbegriff (Groß-/Kleinschreibung wird ignoriert, passt auf Titel und Autor)

[{"key": "ZUXQUGHW",
  "title": "Open-source analysis and visualization of segmented vasculature datasets with VesselVio",
  "type": "journalArticle", "year": "2022",
  "first_author": "Jacob R. Bumgarner",
  "authors": ["Jacob R. Bumgarner", "Randy J. Nelson"],
  "url": "https://linkinghub.elsevier.com/retrieve/pii/S2667237522000443"},
 {"key": "6DU4XPQQ",
  "title": "Robust Vessel Segmentation in Fundus Images",
  "type": "journalArticle", "year": "2013",
  "first_author": "A. Budai",
  "authors": ["A. Budai", "R. Bock", "A. Maier", "J. Hornegger", "G. Michelson"],
  "url": "http://www.hindawi.com/journals/ijbi/2013/154860/"}]

paper_text

Extrahiert den Volltext des PDFs eines Papers mit PyMuPDF (als Python-Abhängigkeit gebündelt, keine Systemtools erforderlich). Erfordert einen in ~/Zotero/storage/ gespeicherten PDF-Anhang.

Argument

Typ

Beschreibung

item_key

string (required)

Zotero-Item-Schlüssel (angezeigt als [KEY] in list_library-Ausgabe oder in search_papers-Ergebnissen)

Gibt den rohen extrahierten Text zurück, beginnend mit Titel, Autoren und Abstract:

            MMLU-Pro: A More Robust and Challenging
              Multi-Task Language Understanding Benchmark
                           1Yubo Wang∗, 1Xueguang Ma∗, 1Ge Zhang, 1Yuansheng Ni, 1Abhranil Chandra, ...
                                 1University of Waterloo, 2University of Toronto, 3Carnegie Mellon University
                                            Abstract
                                In the age of large-scale language models, benchmarks like the Massive Multitask
                                Language Understanding (MMLU) have been pivotal in pushing the boundaries
                                of what AI can achieve in language comprehension and reasoning across diverse
                             domains. ...

Dateistruktur

src/
  main.py    # FastMCP server, tool definitions
  zotero.py  # SQLite queries, data models, formatting

Die Datenbank wird direkt aus ~/Zotero/zotero.sqlite gelesen. PDFs werden aus ~/Zotero/storage/ aufgelöst. Es wird kein API-Schlüssel benötigt.

Available Tools

4 tools
list_libraryA

List collections and papers in the Zotero library. Optionally filter by collection name, paper title, or author. Each paper line includes its item key in [KEY] brackets — use that key in paper_details or paper_text.

Inputs: query. Returns: result

paper_detailsA

Get full metadata for a paper by its item key. Obtain the item_key from list_library output (shown as [KEY] before each paper) or from search_papers results.

Inputs: item_key (required). Returns: result

paper_textA

Extract full text from a paper's PDF using pdftotext. Obtain the item_key from list_library output (shown as [KEY] before each paper) or from search_papers results.

Inputs: item_key (required). Returns: result

search_papersA

Search papers by title or author and return structured results with item keys. Each result includes key, title, type, year, first_author, authors, and url. Use the key in paper_details or paper_text to get full metadata or PDF text.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation4/5

    The tools are mostly distinct: list_library for browsing, search_papers for targeted search, paper_details for metadata, and paper_text for PDF content. However, list_library and search_papers both filter by title/author, which could cause some confusion.

    Naming Consistency3/5

    The naming mixes verb_noun patterns (list_library, search_papers) with noun_noun patterns (paper_details, paper_text). While the paper_* prefix helps, the overall convention is not fully consistent.

    Tool Count5/5

    With only 4 tools, the server is well-scoped for its purpose of accessing a Zotero library. Each tool is essential and there is no unnecessary bloat.

    Completeness4/5

    The tool set covers the core read workflow: discovering papers (list/search), retrieving full metadata, and extracting PDF text. Missing write operations and a dedicated collection endpoint are minor gaps that agents can work around.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP server that lets Claude or any MCP client search and retrieve metadata, notes, full text, citations, and BibTeX from your local Zotero library via its built-in API.
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Minimal Zotero MCP server that enables searching your Zotero library, discovering papers across eight sources, downloading PDFs via a multi-level cascade, and importing them into Zotero.
      6
      1
      MIT