Repository navigation
Releases
Releases · dvdsosa/zotero-native-mcp
v1.0.2
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-mcpRequires 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.