Skip to main content

hardcover_get_my_library

Get your reading list from Hardcover with progressive detail levels.

Parameters

ParameterTypeRequiredDescription
statusstringNoFilter: reading, read, want-to-read, dnf, all (default: all)
detailstringNoDetail level: summary, list (default), full
sort_bystringNoSort: date_added, title, author, rating, progress
pageintNoPage number (default: 1)
page_sizeintNoItems per page (default: 20, max: 100)

Detail Levels

  • summary — Quick stats: counts per status, average progress/rating (~200 tokens)
  • list — Book titles with IDs, status, and progress (default)
  • full — Complete metadata including genres, series, ratings

Examples

{"detail": "summary"}
{"status": "reading"}
{"status": "want-to-read", "page_size": 10}
{"status": "read", "sort_by": "rating"}

Response

Returns books with cross-tool IDs:

  • book_id → for hardcover_update_reading_status
  • isbn → for libby_search, hardcover_add_to_library