Hardcover
@jamesakeech/hardcoverv2026.07.13.1
01README
Monitor a single user's Hardcover reading activity via the Hardcover GraphQL API — profile, the whole tracked library (shelf status, rating, review, pages, read dates), and individual reading sessions (start/finish dates, progress). Read-only, token-authenticated.
02Models
@jamesakeech/hardcoverv2026.07.13.1hardcover.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiToken | string | Hardcover API token (hardcover.app → account settings → Hardcover API). |
| endpoint | string | Hardcover GraphQL endpoint URL |
| userAgent | string | User-Agent header sent with every request (Hardcover asks scripts to |
fn whoami()
Fetch the authenticated user's Hardcover profile (id, username, name,
fn sync_books(statusId?: number, maxBooks?: number)
Pull the user's entire tracked library (all shelves) from Hardcover,
| Argument | Type | Description |
|---|---|---|
| statusId? | number | Only sync books with this shelf status id (omit for all shelves) |
| maxBooks? | number | Stop after writing this many books (omit for the whole library) |
fn sync_reads(maxReads?: number)
Pull the user's reading sessions (user_book_reads) from Hardcover,
| Argument | Type | Description |
|---|---|---|
| maxReads? | number | Stop after writing this many reads (omit for all reads) |
Resources
profile(infinite)— The authenticated Hardcover user\
book(infinite)— A tracked book in the user's library (one record per user_book, keyed by id)
read(infinite)— A reading session (one record per user_book_read, keyed by id)
03Previous Versions
2026.07.08.1Jul 8, 2026
04Stats
A
100 / 100
Downloads
0
Archive size
10.5 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels