Skip to content
MCP server

Goodreads MCP

Read-only Goodreads search, reviews, series, editions and shelves, no API needed

Runs locallyStatus and history
Install
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-ai

Add to claude_desktop_config.json

{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers