# Goodreads MCP

> Goodreads MCP is an open-source MCP server for books and reading. Read-only Goodreads search, reviews, series, editions and shelves, no API needed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/danathar/goodreads-mcp
- **MCP Registry name:** io.github.Danathar/goodreads-mcp-ai
- **Categories:** [books and reading](https://ai-powered.com/categories/books-and-reading), [books and literature](https://ai-powered.com/categories/books-and-literature)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add goodreads-mcp-ai -- uvx goodreads-mcp-ai
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "goodreads-mcp-ai": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "goodreads-mcp-ai": {
      "command": "uvx",
      "args": [
        "goodreads-mcp-ai"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Comicvine](https://ai-powered.com/mcp/comicvine): Comicvine is a freemium MCP server for books and literature.
- [Poetrydb](https://ai-powered.com/mcp/poetrydb): Poetrydb is a freemium MCP server for books and literature.
- [Google Books](https://ai-powered.com/mcp/google-books): Google Books is a freemium MCP server for books and literature.
- [Librivox](https://ai-powered.com/mcp/librivox): Librivox is a freemium MCP server for books and literature.
- [Literal MCP](https://ai-powered.com/mcp/literal-mcp): Literal MCP is an open-source MCP server for books and literature.
- [ISBN-10 digit shape, value discarded](https://ai-powered.com/mcp/isbn-10-digit-shape-value-discarded): ISBN-10 digit shape, value discarded is an MCP server for developer tools.
- [ISBN URN shape, value discarded](https://ai-powered.com/mcp/isbn-urn-shape-value-discarded): ISBN URN shape, value discarded is an MCP server for developer tools.
- [ISBN digit shape](https://ai-powered.com/mcp/isbn-digit-shape): ISBN digit shape is an MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/goodreads-mcp
