# Shelfclub

> Shelfclub is a free MCP server for books and reading. Search a 1.7 million book catalogue by mood, pace or genre, with content warnings. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** iOS, Android, API
- **Website:** https://shelfclub.app
- **MCP Registry name:** app.shelfclub/books
- **Categories:** books and reading
- **Listing updated:** 2026-11-17

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.shelfclub.app/mcp
```

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

```json
{
  "mcpServers": {
    "books": {
      "url": "https://mcp.shelfclub.app/mcp"
    }
  }
}
```

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

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

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

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

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

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

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

- [List Of Books](https://ai-powered.com/mcp/list-of-books): List Of Books is a freemium MCP server for books and literature.
- [inklink](https://ai-powered.com/mcp/inklink): inklink is a free MCP server for books and reading.
- [Fireside Folio](https://ai-powered.com/mcp/fireside-folio): Fireside Folio is a free MCP server for books and reading.
- [book by book](https://ai-powered.com/mcp/book-by-book): book by book is an MCP server for e-commerce.
- [Boxlist](https://ai-powered.com/mcp/boxlist): Boxlist is a free MCP server for events and entertainment.
- [Askwho Casts](https://ai-powered.com/mcp/askwho-casts): Askwho Casts is a paid MCP server for design and media.
- [Reading Journey](https://ai-powered.com/mcp/reading-journey): Reading Journey is a free MCP server for books and reading.
- [Readlink](https://ai-powered.com/mcp/readlink): Readlink is a freemium MCP server for books and reading.

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