Skip to content
MCP server

Shelfclub

Search a 1.7 million book catalogue by mood, pace or genre, with content warnings

Pricing
Free
Platforms
iOS, Android, API
Runs
Remotely
Version
0.2.0
Listing updated
today

About Shelfclub

Shelfclub is a free MCP server for books and reading. It runs as a hosted remote server, so there is nothing to install locally.

Shelfclub is a social reading app, and this read-only server lets an assistant search the catalogue behind it. Beyond title and genre, books can be found by mood or vibe (the site's examples are cozy, devastating, unputdownable and slow-burn) and by pace.

The app attaches content warnings to more than 130,000 books, using 28 warning types, each rated mild, moderate or severe, and readers can hide the ones they never want to meet. The site says a book with no warnings may simply not have been checked yet. Picks are not sponsored.

The app itself tracks reading progress and goals, runs book clubs with polls and chat, shows a friends feed, records lent books and imports libraries from Goodreads or StoryGraph. It is free on iOS and Android, with no ads and no advertising trackers.

Install

Run in a terminal

claude mcp add --transport http books https://mcp.shelfclub.app/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.shelfclub.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "books": {
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "books": {
      "type": "http",
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "books": {
      "serverUrl": "https://mcp.shelfclub.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "books": {
      "type": "http",
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}

What it does

Mood-based search
Find books by mood, vibe, pace or genre.
Large catalogue
Searches a catalogue of 1.7 million books.
Read-only access
The server only reads and changes nothing.
Content warnings
The app tags 28 warning types with severity on over 130,000 books.
Unsponsored picks
Discovery results are not paid placements.
Library import
The app takes Goodreads and StoryGraph exports.

Good for

  • Ask an assistant for a cozy, slow-paced read
  • Find books in a genre without certain content warnings
  • Look up a title in a large catalogue
  • Plan the next pick for a book club

Pricing

Free

Free app and read-only server

Prices change. Check shelfclub.app before you buy.

Shelfclub FAQ

Is it free?

The app is free to track unlimited books, with no ads or credit card, and the MCP server is read-only.

Can it change my library?

No, the server is described as read-only.

What content warnings exist?

28 types, each with a mild, moderate or severe rating, on more than 130,000 books so far.

Can I bring my Goodreads shelf?

Yes, the app imports Goodreads and StoryGraph export files.

Is Shelfclub free?

Yes. Shelfclub is free to use.

How do I add Shelfclub to Claude Code?

Run this command in your terminal: claude mcp add --transport http books https://mcp.shelfclub.app/mcp

What are the best alternatives to Shelfclub?

The closest alternatives to Shelfclub are List Of Books, inklink, Fireside Folio, book by book and Boxlist.

Alternatives to Shelfclub

  1. List Of Books

    MCP server

    Book series reading orders, author series and book-to-series lookups via MCP and REST

    • 5 tools
    • Remote
    • Freemium
    • Books and literature
  2. inklink

    MCP server

    Let your AI assistant log reading progress, rate books and recommend what to read next

    • Remote
    • Free
    • Books and reading
  3. Fireside Folio

    MCP server

    Send free public-domain books, puzzles and articles to your e-reader from chat

    • 13 tools
    • Remote
    • Free
    • Books and reading
  4. book by book

    MCP server

    Square bookstore assistant: plan restocks, import invoices and build orders by chat

    Not checked yet
    • Remote
    • Free trial
    • E-commerce
  5. Boxlist

    MCP server

    Taste-based film, TV, book and game recommendations, read-only and no account needed

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Events and entertainment
  6. Askwho Casts

    MCP server

    Turn articles, your own text and whole books into multi-voice podcast episodes

    Not checked yet
    • Remote
    • Paid
    • Design and media