pyzotero

Manage Zotero libraries via the Zotero Web API v3 with CRUD operations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gabrielvuksani/wotann --skill pyzotero-gabrielvuksani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pyzotero
Source: https://github.com/gabrielvuksani/wotann/tree/main/skills/scientific/pyzotero
Command: npx skills add https://github.com/gabrielvuksani/wotann --skill pyzotero-gabrielvuksani

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It removes the manual effort of managing a Zotero library when you need to programmatically search, update, and export bibliographic data or attach research PDFs.

Core Features & Use Cases

  • Manage Zotero items and collections via the Zotero Web API v3: read items/collections, create and update references, and delete items.
  • Handle tags and search effectively: filter libraries by query, item type, tags, and pagination, including full-text search scenarios.
  • Upload and retrieve attachment files and exported citations: download/upload PDFs and export citations in formats like BibTeX or CSL-JSON for downstream research automation.

Quick Start

Use the pyzotero skill to fetch the top 10 items from your Zotero library after authenticating with your ZOTERO_LIBRARY_ID and ZOTERO_API_KEY.

Frequently Asked Questions about pyzotero

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Zotero library management tasks like searching and updating items programmatically?

Automate Zotero library management by using the Zotero Web API v3 to perform CRUD operations on items and collections. You can read, create, update, and delete references programmatically, removing the need for manual library updates.

Do I need an API key to fetch items and upload PDF attachments to my Zotero library?

Yes, you need Zotero API credentials including a ZOTERO_LIBRARY_ID and ZOTERO_API_KEY to authenticate. Uploading and retrieving PDF attachment files also requires enabling optional file permissions for your API key.

Can I export citations from Zotero in BibTeX or CSL-JSON formats for downstream research automation?

Yes, you can export citations from Zotero in BibTeX or CSL-JSON formats. This allows you to retrieve exported citation data programmatically for use in downstream research automation workflows and bibliography management.

What's the best way to filter a Zotero library by tags, item type, or full-text search?

The best way to filter a Zotero library is using the Zotero Web API v3 query parameters. You can filter libraries by search query, item type, tags, and pagination, including full-text search scenarios for precise item retrieval.

How do I handle errors when managing Zotero collections and saved-search metadata via the API?

Handle errors when managing Zotero collections and saved-search metadata by catching ZoteroError subclasses. The API provides structured error handling methods for reads, writes, and pagination operations to manage exceptions effectively.