Goodreads MCP
Read-only Goodreads search, reviews, series, editions and shelves, no API needed
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 2026.11.0
- Listing updated
- today
Similar MCP servers
About Goodreads MCP
Goodreads MCP is an open-source MCP server for books and reading. It runs locally on your machine and is started by your AI client.
Goodreads retired its public API in December 2020, so this server reaches public pages instead: the site's autocomplete endpoint, data embedded in book pages, the GraphQL backend its own site uses, and shelf feeds. It needs no login or cookies, never writes, and every tool carries MCP read-only annotations.
Tools chain naturally because each result carries a book id, so an agent can go from similar books to reviews on one recommendation. Review lookups can filter by rating, language, spoilers and text, and paginated lookups return up to 100 items with a has_more flag. A compare tool ranks up to ten books by rating with positive and critical shares.
The README is candid about breakage: the shelf RSS feed has returned 404 since October 2026, so get_shelf raises ShelfFeedUnavailable, and the review list page became login-only in September 2026. It is a fork of shreeyachand/goodreads-mcp, needs Python 3.11 or newer, and is published on PyPI as goodreads-mcp-ai.
Install
Run in a terminal
claude mcp add goodreads-mcp-ai -- uvx goodreads-mcp-aiAdd to claude_desktop_config.json
{
"mcpServers": {
"goodreads-mcp-ai": {
"command": "uvx",
"args": [
"goodreads-mcp-ai"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"goodreads-mcp-ai": {
"command": "uvx",
"args": [
"goodreads-mcp-ai"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"goodreads-mcp-ai": {
"type": "stdio",
"command": "uvx",
"args": [
"goodreads-mcp-ai"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"goodreads-mcp-ai": {
"command": "uvx",
"args": [
"goodreads-mcp-ai"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"goodreads-mcp-ai": {
"command": "uvx",
"args": [
"goodreads-mcp-ai"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GOODREADS_USER_IDNumeric Goodreads profile ID (the number in goodreads.com/user/show/<ID>-name). Default user for the shelf tools; optional, can also be passed per tool call.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- search_books
- Search books by title with author, rating and cover
- get_book
- Book details, ratings histogram, series memberships and identifiers
- get_reviews
- Paginated reader reviews with rating, language and spoiler filters
- similar_books
- Paginated readers-also-enjoyed recommendations
- author_books
- An author's bibliography ranked by popularity
- series_books
- Books in a series with reading order
- get_editions
- Editions with format, ISBN, publisher and date
- book_lists
- Listopia lists a book appears on
- popular_books
- Most popular books by year or month
- compare_books
- Rank up to ten books by rating
- get_shelf
- Books on a public shelf
- list_shelves
- Shelf names from a public profile
What it does
- Review filters
- Filter reviews by rating range, sort, language, text and spoilers.
- Book graph
- Similar books, author bibliography, series order, editions and Listopia lists.
- Book comparison
- Ranks up to ten books by rating.
- Popular by date
- Most popular books for a year or month.
- Read-only access
- No login, cookies or writes; public data only.
- Paged results
- Pages in batches of 20, up to 100 results.
Good for
- Find readers' recommendations similar to a book
- Read recent non-spoiler reviews in one language
- List a series in reading order
- Compare candidate books by rating
- See all editions and ISBNs of a title
Pricing
Open source
Free, MIT-licensed fork
Goodreads MCP FAQ
Does it need a Goodreads login?
No. It uses public data and no cookies.
Does it use the Goodreads API?
No; the README says the API has not existed since December 2020.
Why might shelf lookups fail?
The README says the shelf RSS feed has answered 404 since October 2026.
What Python version is required?
Python 3.11 or newer.
How do I set my default shelf user?
Set GOODREADS_USER_ID or a user_id in the config file.
Is Goodreads MCP free?
Yes. Goodreads MCP is open source, so you can use and self-host it for free.
How do I add Goodreads MCP to Claude Code?
Run this command in your terminal: claude mcp add goodreads-mcp-ai -- uvx goodreads-mcp-ai
What are the best alternatives to Goodreads MCP?
The closest alternatives to Goodreads MCP are Comicvine, Poetrydb, Google Books, Librivox and Literal MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
