search_booksLABSCO SUMMARY
The reading tracker you do not have to open.
Adding a book you just started, rating one you finished, and checking what is next in a series are the three things a tracker is for — and all three are one sentence here.
What it is
A Python server over Hardcover, the book tracking site. It reads your library, reviews, stats and reading goal, and writes back status, ratings, reading dates, ownership and the goal itself. It runs locally through uvx with your own token.
What you get
- search_books, get_book, get_author, get_series and get_edition find a title and return the record, including which edition and where it sits in a series
- get_user_library, get_user_book and get_user_reviews cover your shelf, one entry on it, and what you wrote about it
- set_user_book writes status, rating and reading dates — the write you will use most
- get_reading_journal, get_reading_stats, get_reading_goal and set_reading_goal cover the year's progress and the target
- get_owned_books and set_edition_owned track which physical or digital edition you actually have
Requirements
Install uv, get an API token from hardcover.app/account/api, and set HARDCOVER_API_TOKEN in your client config — uvx fetches the package, so there is nothing to install by hand. It wants a recent Python. The token stays on your machine and the server runs locally.
Setup effort
One command plus a key — uvx hardcover-mcp, then supply credentials
USE CASES
Logging a book you just started
Find it, then set status and start date in the same breath.
Checking what you are in the middle of
Your shelf filtered to what is currently open, with the entry's own detail behind it.
Reading a series in the right order
The series record puts the books in sequence, so the next one is not a guess.
Keeping the yearly goal honest
Read the goal, read the stats, and move the target when the year turns out differently.
Working out which edition you own
Editions and ownership are tracked separately from reading status, which is what makes a shelf audit possible.
Following an author's back catalogue
The author record, then a search for what you have not read yet.
29 tools
Listed in project docs. Your client may show a different list.
get_bookget_editionget_seriesget_authormeget_reading_statsget_reading_goalget_user_libraryget_user_bookget_user_reviewsget_reading_journalget_owned_booksset_reading_goalset_user_bookset_edition_ownedadd_user_book_readupdate_user_book_readdelete_user_bookdelete_user_book_readadd_journal_entrydelete_journal_entryget_my_listsget_listcreate_listupdate_listdelete_listadd_book_to_listremove_book_from_listBEFORE YOU INSTALL
What to know first
Tools you get
29 tools named in the project's documentation.
Requires
- uvx on PATH
- HARDCOVER_API_TOKEN in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
uvx hardcover-mcpMCP Clients
VS Code
{
"servers": {
"hardcover": {
"command": "uvx",
"args": [
"hardcover-mcp"
],
"env": {
"HARDCOVER_API_TOKEN": "<YOUR_HARDCOVER_API_TOKEN>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"hardcover": {
"command": "uvx",
"args": [
"hardcover-mcp"
],
"env": {
"HARDCOVER_API_TOKEN": "<YOUR_HARDCOVER_API_TOKEN>"
}
}
}
}