Connect CaliMob to Claude — AI Assistant via MCP

Connect your CaliMob library to Claude — or any MCP client — so an AI assistant can give you personalised, spoiler-free answers about your own books. Available on Pro plans and higher.

1

What you get

  • Personalised recommendations — the assistant sees your reading history and ratings.
  • No spoilers — it knows how far you’ve read and won’t reveal what’s ahead.
  • Your reading stats — “how many books have I read this year?”
  • Search your library — “that book about the Templars I read”.

Access is read-only and scoped to your account: the assistant can look, but never change or delete anything.

2

Generate your token

In CaliWeb, open Profile → API Settings and create a new token. Copy it — you’ll paste it into the config below. You can revoke it at any time.

3

Configure Claude Desktop

You need Node.js installed. Add this to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "calimob": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://caliwebapp.com/api/mcp",
        "--header", "Authorization:Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Replace YOUR_TOKEN_HERE with the token from step 2. mcp-remote is the standard bridge and is fetched automatically by npx — there is nothing to install.

4

Restart and try it

Restart Claude Desktop, then ask something like “Recommend a book from my library for the weekend” or “How am I doing on my reading goal this year?”

Available tools

ToolWhat it does
get_user_profileYour profile and plan
get_reading_historyYour recent books with ratings
get_user_preferencesFavourite authors and average rating
get_reading_progressHow far you are in a given book (no-spoiler)
search_user_booksSearch your library by title or author
get_user_statisticsBooks read, by status, this year

Private by design. Every tool is read-only and scoped to your account — other users’ data is never visible. Your token is personal, sent over HTTPS, and can be revoked anytime from Profile → API Settings. MCP access is a Pro (or higher) feature.

Last updated: July 20, 2026