Interact with Zotero reference management libraries using the pyzotero Python client. Retrieve, create, update, and delete items, collections, tags, and attachments via the Zotero Web API v3. Use this skill when working with Zotero libraries programmatically, managing
Installs just this skill. Get the whole plugin for auto-invocation.
⚡ How it fires
How this skill gets triggered: by you, by Claude, or both.
Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/pyzotero
👁️ Context preview
The summary Claude sees to decide when to auto-load this skill.
Interact with Zotero reference management libraries using the pyzotero Python client. Retrieve, create, update, and delete items, collections, tags, and attachments via the Zotero Web API v3. Use this skill when working with Zotero libraries programmatically, managing
📊 Stats
Stars31,545
Forks3,146
LanguagePython
LicenseMIT
📦 Ships with scientific-agent-skills
</> SKILL.md
pyzotero.SKILL.md
---name: pyzotero
description: Interact with Zotero reference management libraries using the pyzotero Python client. Retrieve, create, update, and delete items, collections, tags, and attachments via the Zotero Web API v3. Use this skill when working with Zotero libraries programmatically, managing bibliographic references, exporting citations, searching library contents, uploading PDF attachments, or building research automation workflows that integrate with Zotero.
allowed-tools: Read Write Edit Bash
license: MIT License
compatibility: Requires Python 3.10+ and pyzotero 1.13+. Web API access needs a Zotero API key. Optional CLI and MCP extras require Zotero 7 with local API access enabled.
required_environment_variables: [{"name": "ZOTERO_API_KEY", "prompt": "Zotero API key.", "required_for": "full functionality"}, {"name": "ZOTERO_LIBRARY_ID", "prompt": "Zotero library id.", "required_for": "full functionality"}, {"name": "ZOTERO_LIBRARY_TYPE", "prompt": "Zotero library type: 'user' or 'group' (default 'user').", "required_for": "optional features"}]
metadata: {"version": "1.1", "skill-author": "K-Dense Inc.", "openclaw": {"primaryEnv": "ZOTERO_API_KEY", "envVars": [{"name": "ZOTERO_API_KEY", "required": true, "description": "Zotero API key."}, {"name": "ZOTERO_LIBRARY_ID", "required": true, "description": "Zotero library id."}, {"name": "ZOTERO_LIBRARY_TYPE", "required": false, "description": "Zotero library type: 'user' or 'group' (default 'user')."}]}}
---# Pyzotero
Pyzotero is a Python wrapper for the [Zotero API v3](https://www.zotero.org/support/dev/web_api/v3/start). Use it to programmatically manage Zotero libraries: read items and collections, create and update references, upload attachments, manage tags, and export citations.
zot = Zotero(library_id='123456', library_type='user', local=True)
items = zot.items()
```
### Local Zotero 7 (CLI or MCP, no API key)
For searching a locally running Zotero desktop app (including full-text PDF search), use the CLI or MCP server instead of the Web API. Both require Zotero 7 with local API access enabled. See [references/cli.md](references/cli.md) and [references/mcp.md](references/mcp.md).