Cli Anything Zotero

cli-anything-zotero

cli-anything-zotero is an agent-native CLI for Zotero desktop. It does not reimplement Zotero. Instead, it composes Zotero's real local surfaces:

Installation

pip install -e .

Entry Points

cli-anything-zoteropython -m cli_anything.zotero

Important Constraints

• search items, item export, item citation, and item bibliography require Zotero's Local API to be enabled.
• note add depends on the live Zotero GUI context and expects the same library to be selected in the app.
• Import-time PDF attachment support is limited to items created in the same connector session; arbitrary existing-item attachment upload is still out of scope.
• Experimental SQLite write commands are local-only, user-library-only, and should be treated as non-stable power-user operations.
• If a bare key is duplicated across libraries, set session use-library <id> before follow-up commands.

Command Groups

App

Application and runtime inspection commands.

Collection

Collection inspection and selection commands.

Item

Item inspection and rendering commands.

Search

Saved-search inspection commands.

Tag

Tag inspection commands.

Style

Installed CSL style inspection commands.

Import

Official Zotero import and write commands.

Note

Read and add child notes.

Session

Session and REPL context commands.

Examples

Runtime Status

Inspect Zotero paths and backend availability.

cli-anything-zotero app status --json

Read Selected Collection

Persist the collection selected in the Zotero GUI.

cli-anything-zotero collection use-selected --json

Render Citation

Render a citation using Zotero's Local API.

cli-anything-zotero item citation <item-key> --style apa --locale en-US --json

Add Child Note

Create a child note under an existing Zotero item.

cli-anything-zotero note add <item-key> --text "Key takeaway" --json

Build LLM Context

Assemble structured context for downstream model analysis.

cli-anything-zotero item context <item-key> --include-notes --include-links --json

Version

0.1.0