Skip to content

Releases: PhoenixChenLu/zotero-local-mcp-bridge

Zotero Local MCP Bridge v0.1.56

28 Jun 14:40
@PhoenixChenLu PhoenixChenLu
v0.1.56
99f42c2

Choose a tag to compare

View all tags
Zotero Local MCP Bridge v0.1.56 Latest
Latest

Zotero Local MCP Bridge v0.1.56

This is the first public release candidate for Zotero Local MCP Bridge, a local-first Zotero plugin that hosts an MCP endpoint inside Zotero Desktop.

Install

  1. Download zotero-local-mcp-bridge.xpi from this release.
  2. Open Zotero and go to Tools -> Plugins.
  3. Drag the XPI file into the plugin manager window.
  4. Confirm installation and restart Zotero.
  5. Install the matching agent skill:
    • English: zotero-local-mcp-bridge-skill-en-v0.1.56.zip
    • Simplified Chinese: zotero-local-mcp-bridge-skill-zh-cn-v0.1.56.zip
  6. Configure your MCP-capable agent to connect to:
http://127.0.0.1:23119/zotero-local-mcp-bridge/mcp

Included Assets

  • zotero-local-mcp-bridge.xpi: Zotero plugin.
  • zotero-local-mcp-bridge-skill-en-v0.1.56.zip: English agent skill.
  • zotero-local-mcp-bridge-skill-zh-cn-v0.1.56.zip: Simplified Chinese agent skill.
  • updates.json: Zotero add-on update manifest. Upload this with the XPI so Zotero can validate the add-on update URL.
  • checksums-v0.1.56.txt: SHA256 checksums for release assets.

Highlights

  • Plugin-hosted MCP endpoint inside Zotero Desktop.
  • No separate Node, Python, or sidecar MCP process.
  • Local loopback access through Zotero's connector server.
  • Read/search support for local Zotero items, collections, attachments, annotations, saved searches, audit records, and backup state.
  • Write support for item metadata, creators, tags, notes, collections, attachments, saved searches, imports, annotations, backup settings, controlled trash, and duplicate merge workflows.
  • BibTeX, RIS, and CSL JSON import/export.
  • Citation and bibliography formatting through Zotero.
  • Mandatory dry-run for write operations.
  • Agent-layer approval metadata for readonly, askforapprove, and yolo modes.
  • Local audit and file-level backup/undo workflows for file-risk operations.
  • Zotero settings page with localized UI resources.

Safety Boundaries

  • Does not write through the Zotero Web API.
  • Does not require, read, or store ZOTERO_API_KEY.
  • Does not write directly to zotero.sqlite.
  • Does not expose arbitrary Zotero JavaScript eval as an ordinary management tool.
  • Does not support group libraries in this release.
  • Does not permanently erase Zotero records, empty Zotero trash, or directly delete existing attachment files.

Notes

Start with readonly or askforapprove mode unless you already understand the write safety model. In approval mode, agents should summarize pending write operations briefly and execute only after user approval.

Assets 8
Loading