Skip to content

Releases

v1.0.2

Choose a tag to compare

@dvdsosa dvdsosa released this 07 Oct 12:09

First GitHub release, and the first archived on Zenodo, of zotero-native-mcp, an MCP server that reads and writes a Zotero 10+ library entirely offline through Zotero's native local API. No plugin, no API key, no cloud.

Highlights

  • 28 tools covering search, items, collections, tags, saved searches, full text, export, attachments and trash, in personal and group libraries.
  • Writes through Zotero 10's local API: create collections, add references and attach local PDFs.
  • Deletion goes to Zotero's trash by default and can be undone with zotero_restore_items / zotero_restore_collection.
  • Verified against a real Zotero 10.0.1 on macOS 26.6, Windows 11 and Ubuntu 24.04. CI runs on Linux, macOS and Windows with Node 22, 24 and 26.

Install

claude mcp add --scope user zotero-native-mcp -- npx -y zotero-native-mcp

Requires Zotero 10+ with "Allow other applications on this computer to communicate with Zotero" enabled, and Node.js 22+.

Changes since v1.0.1

  • Adds CITATION.cff: GitHub now offers "Cite this repository", and the Zenodo record carries author, ORCID and affiliation.
  • The server now reports its real version to MCP clients.
  • Issue templates converted to GitHub issue forms; Dockerfile added for MCP indexers; documentation fixes.
  • Release CI waits for npm to serve a version before registering it in the MCP Registry.

Warning

This server can modify and delete items in your Zotero library. Back up your Zotero data directory before use.