Skip to content
TakoAPI
Back to skills

pyzotero

by killgfat

Web & Frontend Development
1.5kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Python scripts for Zotero - supports both local API and online Web API, with ZOTERO_LOCAL environment variable.

Description

What This Skill Does

Python scripts wrapping the pyzotero library to interact with Zotero reference libraries. Supports search, full-text search, item retrieval, adding items individually or in bulk from JSON, and full collection management. Works with both a locally running Zotero instance and the Zotero Web API.

Gives command-line and script access to Zotero without opening the desktop app, making library management automatable and composable with other tools.

When to Use It

  • Search a research library by keyword or phrase
  • Find papers containing specific terms inside PDFs
  • Add journal articles with metadata from the command line
  • Organize references into collections and subcollections
  • Export search results as JSON for scripting pipelines

Example Workflow

INPUT

User asks: find all papers about 'attention mechanisms' including PDF content, then add results to a collection

AGENT
  1. 1

    Run full-text search: python3 scripts/zotero_tool.py search -q "attention mechanisms" --fulltext --json

  2. 2

    Parse returned item keys from JSON output

  3. 3

    List existing collections to find the target collection key: python3 scripts/zotero_tool.py listcollections

  4. 4

    Add each matching item to the collection: python3 scripts/zotero_tool.py collection-add-item ITEM_KEY -c COLLECTION_KEY

OUTPUT

All matching papers are added to the specified Zotero collection

Requirements

  • Zotero 7 or later installed and running (for local mode); enable local API under Settings > Advanced
  • ZOTERO_USER_ID environment variable (online mode only)
  • ZOTERO_API_KEY from zotero.org/settings/keys (online mode only)

Installation

clawhub install killgfat/pyzotero

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links