Module write

Write MCP tools — Zotero Web API operations.

All write tools go through the Zotero Web API (never direct SQLite writes). They require ZOTERO_API_KEY to be set.

Latency

Write tools have the same latency as the Python server (~200-500ms) because the bottleneck is the Zotero API, not our code. This is expected and acceptable — writes are rare in MCP usage.

Functions

get_write_client 🔒

Get write client. Checks both write-gate flag and API key.

resolve_item_key 🔒

Resolve an identifier that may be either a Zotero item key (8-char) or a BBT citekey.

zotero_add_note

zotero_add_tags

zotero_add_to_collection

zotero_attach_pdf

zotero_create_collection

zotero_create_item

zotero_delete_item

zotero_export_bibtex

Export a collection or item list as BibTeX/BibLaTeX — native, no BBT needed.

zotero_fetch_missing_pdfs

Scan items for missing PDFs and resolve from 9 open-access sources.

zotero_get_bibliography

Generate formatted bibliography — native for APA/IEEE, BBT fallback for others.

zotero_get_bibtex

Export items as BibTeX/BibLaTeX — native implementation, no BBT needed.

zotero_merge_items

zotero_remove_from_collection

zotero_update_item