Search books in the Calibre library using Calibre's search syntax.

Search syntax examples:

• Simple text: "robot" (searches all fields)

• Field-specific: author:asimov, title:"magic tree house", tag:fiction

• Boolean: author:asimov AND title:foundation

• Series: series:"magic tree house"

Args: query: Search expression using Calibre's query language fields: Fields to include in results limit: Max number of results (omit for all) sort_by: Field to sort by

Get detailed metadata for a book by its Calibre ID.

Returns title, authors, series, tags, formats, file paths, and all other metadata.

Args: book_id: The Calibre book ID

Get the absolute file path of a book's EPUB file.

This is the core tool for the reading-quiz workflow — returns the EPUB path so it can be unzipped and chapters read directly.

Args: book_id: The Calibre book ID

List all books in a series, sorted by series_index.

Great for seeing the full reading order of a series like "Magic Tree House".

Args: series_name: Name of the series to look up fields: Fields to include in results

List all custom columns defined in the Calibre library.

Custom columns are user-defined metadata fields beyond the standard fields (title, author, tags, etc.).

Args: details: Include column types, default values, and other metadata

Set the value of a custom column for a book.

Custom columns are referenced by their lookup name (e.g. "#status", "#rating"). Use get_custom_columns() to see available columns.

Args: book_id: The Calibre book ID column: Custom column lookup name (e.g. "#status") value: Value to set append: If True, append to existing values instead of replacing

Set standard metadata fields for a book.

Supported fields: title, authors, author_sort, comments, cover, isbn, languages, pubdate, publisher, rating, series, series_index, sort, tags, title_sort, identifiers.

Note: this REPLACES field values. For tags, pass all desired tags comma-separated. For identifiers: "isbn:123456,goodreads:789".

Args: book_id: The Calibre book ID fields: Dict of field_name → value, e.g. {"tags": "sci-fi,classics", "series": "Foundation"}