calibre

Search Calibre library databases with calibredb and emit JSON results.

2|1|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/stbenjam/claude-nine --skill calibre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calibre
Source: https://github.com/stbenjam/claude-nine/tree/main/plugins/books/skills/calibre
Command: npx skills add https://github.com/stbenjam/claude-nine --skill calibre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly search and query your Calibre library databases using calibredb, enabling you to locate books, track reading status, and derive library statistics without manually inspecting records.

Core Features & Use Cases

  • Library-wide search: Query your Calibre library using calibredb with the configured library URL and credentials.
  • Custom field support: Return results including standard and custom fields (e.g., read, dateread, goodreads rating, pages).
  • Use Case: Generate a TBR list by filtering for unread and non-archived books, or compute library statistics over time.

Quick Start

Run a sample query using calibredb, for example:

/Applications/calibre.app/Contents/MacOS/calibredb list --with-library='http://killington.home.bitbin.de:8454/#' --username='calibre' --password='calibre' --fields='title,authors,series,series_index,*read,*archived' --search='#read:No' --for-machine | python3 -m json.tool

Frequently Asked Questions about calibre

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

FAQPage Schema
How do I search my Calibre library database using command-line tools?

Calibre library searching uses calibredb, a command-line tool that queries your Calibre database to retrieve books and metadata. You specify your library URL, credentials, and search syntax to filter books by title, author, series, reading status, or custom fields, returning results in JSON format for programmatic use.

Can I filter my Calibre library by reading status and custom fields?

Yes. calibredb supports filtering by built-in fields like title and authors, plus custom fields such as read status, date read, ratings, and archive flags. Use Calibre search syntax (e.g., #read:No) to compose complex queries and select specific fields to return.

What's the best way to generate a to-be-read list from my Calibre library?

Query your Calibre library with calibredb using search filters for unread and non-archived books, selecting fields like title, authors, and series. The Skill returns machine-readable JSON output that you can process to create prioritized reading lists or track library statistics.

Does calibredb work with remote Calibre servers?

Yes. calibredb connects to both local Calibre databases and remote Calibre servers via HTTP URL with username and password authentication, allowing you to query libraries hosted on network servers or local instances.

How do I extract library statistics from my Calibre database?

Use calibredb to run aggregating queries across your library, selecting relevant fields and applying search filters. The JSON output enables analysis of reading patterns, completion rates, rating distributions, and series progress over time.