Getting started
Turn it on
This module starts inactive. Ask your agent to activate it, or flip the switch on the Books card on the homepage. Activation calls create_database with moduleSlug: "books" and a name you choose, and unlocks the tools on this page. If it was active before and got switched off, the same call reactivates it instead of creating a duplicate.
Reference
Fields
What an entry in this module looks like.
| Field | Type | Notes |
|---|---|---|
| book | string | Required. Title of the book (author may be included, e.g. 'Dune by Frank Herbert'). |
| status | want_to_read | reading | read | Reading status: 'want_to_read' (on the list, not started), 'reading' (in progress), or 'read' (finished). Defaults to unset if omitted. |
| rating | number | Rating on a 1-5 scale, typically given once the book is marked 'read'. |
| notes | string | Free-form notes about the book, e.g. thoughts, quotes, or reasons for reading it. |
| catalogId | string | Id of a book_catalog row from books_confirm_match, to attach structured metadata (author, ISBN, year, page count, cover). Optional: book (free text) is always fully sufficient on its own to log a book, with or without a catalog match. |
Reference
Tools
Books has 9 dedicated tools once active: add, list, update, and delete, plus a few built for how this module actually gets used.
books_attach_photobooks_add_entrybooks_list_entriesbooks_update_entrybooks_delete_entrybooks_list_currently_readingbooks_reading_statsbooks_lookupbooks_confirm_match
Full tool reference, with parameters and return valuesTry it
Example prompts
Talk to your agent like this once Books is active. It picks the right tool and fields on its own.
Add 'Project Hail Mary' to my want to read list.
Look up 'Project Hail Mary' and add it to my want to read list with the matched metadata.
What am I currently reading?
Give me my reading stats.