hardcover

name	hardcover
description	Query reading lists and book data from Hardcover.app via GraphQL API. Triggers when user mentions Hardcover, asks about their reading list/library, wants book progress, searches for books/authors/series, or references "currently reading", "want to read", or "books I've read". Also use for syncing reading data to other systems (Obsidian, etc.) or tracking reading goals.
homepage	https://hardcover.app
metadata	{"openclaw":{"emoji":"📚","requires":{"env":["HARDCOVER_API_TOKEN"]}}}

Hardcover GraphQL API

Query your reading library, book metadata, and search Hardcover's catalog.

Configuration

• Env variable: HARDCOVER_API_TOKEN from https://hardcover.app/settings
• Endpoint: https://api.hardcover.app/v1/graphql
• Rate limit: 60 req/min, 30s timeout, max 3 query depth

Authentication

All queries require Authorization: Bearer {token} header (token from settings, add Bearer prefix):

curl -X POST https://api.hardcover.app/v1/graphql \
  -H "Authorization: Bearer $HARDCOVER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "query { me { id username } }"}'