Guide · Agent skill
How to use the Zotero Command-Line Helper agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
This guide explains the Zotero Command-Line Helper agent skill, which lets an AI agent work with your Zotero desktop library through a command-line tool rather than guessing at its files. It is written for readers who have never used agent skills before. By the end you will know what the skill can do, how to install it, how to ask for things in plain language, and what to check before you rely on it.
Zotero Command-Line HelperHKUDS/CLI-Anything · Apache-2.0 Download the skill Quick start
- 1Install Python and pip. Make sure Python with pip is available on your computer.
- 2Install the tool. From the tool's folder, run pip install -e . as shown in the SKILL.md.
- 3Place the skill. Unzip the downloaded ZIP into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills in the Claude apps.
- 4Open Zotero and enable the Local API. Start Zotero desktop and make sure its Local API is enabled for search, export, citation and bibliography commands.
- 5Test the connection. Ask the agent to check Zotero status, or run cli-anything-zotero app status --json.
- 6Make a natural request. Ask for a search, a citation or a bibliography in plain language that mentions Zotero.
What does the Zotero Command-Line Helper skill let the agent do?
The skill provides a command-line tool, cli-anything-zotero, for the Zotero desktop reference manager. According to the skill's source, it does not reimplement Zotero. It works with Zotero's own local interfaces so the agent can operate the real app.
With the skill, an agent can list collections, search items, read notes and attachments, render citations and bibliographies in styles such as APA, export records, add child notes to existing items, and assemble item details into structured context for analysis.
How do you install the Zotero skill?
Download the skill ZIP from this page and unzip it. Then choose one of the following places for it. For a personal setup, unzip it into ~/.claude/skills/. For a single project, unzip it into the project's .claude/skills/ folder. Alternatively, upload the ZIP in the Claude apps under Settings → Capabilities → Skills.
The command-line tool itself is installed with Python and pip. The skill's SKILL.md lists this install command, run from the tool's folder:
pip install -e .What do you need before it works?
You need Python with pip and the Zotero desktop app running. Some commands also need Zotero's Local API turned on. The skill lists these commands as requiring the Local API: search items, item export, item citation, and item bibliography. The skill also includes an enable-local-api command and a launch command in its App group.
Note that note add depends on the live Zotero GUI and expects the same library to be selected in the app.
- Python with pip
- Zotero desktop app running
- Zotero Local API enabled for search, export, citation and bibliography commands
How do you trigger the skill with natural requests?
You do not need to type the command yourself. Once the skill is installed, describe what you want in plain language and mention Zotero. The agent decides when to use the tool. Good requests name the thing you want done, such as searching your library, formatting a citation, or exporting records.
If you know a specific item key, include it so the agent can target that item. The skill's examples use placeholders such as <item-key>.
- Search my Zotero library for items about transformer interpretability.
- Give me an APA citation for this item in Zotero.
- Export the records in my selected Zotero collection.
- Add a note to this item saying the key takeaway is the sample size limit.
What do the example commands look like?
These are the examples given in the skill's source. The agent runs commands like these for you, but seeing them helps you understand what happens. Replace <item-key> with a real item key from your library.
Check runtime status with app status, read the collection you selected in the GUI with collection use-selected, render an APA citation with item citation, add a child note with note add, and build LLM context with item context.
cli-anything-zotero app status --json
cli-anything-zotero collection use-selected --json
cli-anything-zotero item citation <item-key> --style apa --locale en-US --json
cli-anything-zotero note add <item-key> --text "Key takeaway" --json
cli-anything-zotero item context <item-key> --include-notes --include-links --jsonWhat are the safety notes?
The skill runs scripts, so treat it as code you are choosing to run. The skill's listing states that it runs scripts and does not use the network. Be cautious with write operations. The SKILL.md says experimental SQLite write commands are local-only, user-library-only, and should be treated as non-stable power-user operations that could affect library data. Keep a backup of your library before using them.
Attaching files to existing items is out of scope. Import-time PDF attachment support is limited to items created in the same connector session.
- Experimental SQLite write commands are non-stable and could affect library data.
- Arbitrary attachment upload to existing items is not supported.
- If a bare key is duplicated across libraries, run session use-library <id> before follow-up commands.
What tips help the skill work smoothly?
Start with app status to confirm Zotero is reachable. If citation or search commands fail, check that the Local API is enabled. If you are working across several libraries, set the library explicitly with session use-library before asking about items with the same key. Use item context when you want an agent to analyze an item with its notes and links included.
- Run app status first to check the setup.
- Keep Zotero open and the right library selected for note add.
- Use --json output when another tool or pipeline will read the results.
What people use it for
- Searching your library for items on a topic and listing the results.
- Rendering an APA citation for a specific item with item citation.
- Exporting records from a selected collection for a writing or analysis pipeline.
- Assembling an item's details, notes and links into structured context for an analysis step.
- Adding a child note with a key takeaway to an existing item.
Frequently asked questions
How do I install the Zotero Command-Line Helper skill?
Download the skill ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. You can also upload it in the Claude apps under Settings → Capabilities → Skills. The command-line tool is installed with pip install -e . as listed in SKILL.md.
What do I need to run the Zotero skill?
You need Python with pip and the Zotero desktop app running. Search, export, citation and bibliography commands also need Zotero's Local API enabled. The note add command depends on the live Zotero GUI.
Is the Zotero skill free?
The source provided for this page states the licence as Apache-2.0. It does not state pricing, so check the project's licence file for terms.
Does the skill change my Zotero library?
Commands such as note add can add child notes to existing items. The SKILL.md also describes experimental SQLite write commands that could affect library data and should be treated as non-stable. Back up your library before using write features.
Can the agent attach PDFs to existing items?
No. The SKILL.md says arbitrary existing-item attachment upload is out of scope. PDF attachment support is limited to items created in the same connector session.
Why does my search or citation command fail?
The most likely cause is that Zotero's Local API is not enabled. Enable it, keep Zotero open, and run app status to confirm the connection. If a bare key appears in more than one library, set the library with session use-library first.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits researchers and students who want an agent to search their Zotero library and format citations, and developers who want structured Zotero item data in a pipeline. It is less suited to anyone who needs stable, unattended edits or attachment uploads to existing items, since the SKILL.md marks write features as experimental and attachment upload as out of scope.
Download the skill