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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.shelfclub.app/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"books": {
"url": "https://mcp.shelfclub.app/mcp"
}
}
}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

List Of Books
MCP serverBook series reading orders, author series and book-to-series lookups via MCP and REST
- 5 tools
- Remote
- Freemium
- Books and literature

inklink
MCP serverLet your AI assistant log reading progress, rate books and recommend what to read next
- Remote
- Free
- Books and reading

Fireside Folio
MCP serverSend free public-domain books, puzzles and articles to your e-reader from chat
- 13 tools
- Remote
- Free
- Books and reading

book by book
MCP serverSquare bookstore assistant: plan restocks, import invoices and build orders by chat
Not checked yet- Remote
- Free trial
- E-commerce

Boxlist
MCP serverTaste-based film, TV, book and game recommendations, read-only and no account needed
Not checked yet- 5 tools
- Remote
- Free
- Events and entertainment

Askwho Casts
MCP serverTurn articles, your own text and whole books into multi-voice podcast episodes
Not checked yet- Remote
- Paid
- Design and media