Calibremcp · LLM Mart

Name: Calibremcp
Author: LLM Mart

No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.

📖 Installation Guide — download the .exe from Releases, double-click, done

FastMCP 3.2 MCP server for Calibre e-book library management — AI-assisted search, RAG, and agentic workflows for Sandra's 1000+ book library.

Quick Start

Download Calibre MCP_*_x64-setup.exe from Releases → double-click → launch Calibre MCP. Install guide.

Claude Desktop one-liner (MCPB bundle): download calibre-mcp.mcpb from Releases and install via Settings → MCP Servers → Install from file.

Developers from source:

git clone https://github.com/sandraschi/calibremcp
cd calibremcp
just sync
just start-webapp

// claude_desktop_config.json { "mcpServers": { "calibre-mcp": { "command": "uv", "args": ["run", "calibre-mcp"], "env": { "CALIBRE_LIBRARY_PATH": "L:/Multimedia Files/Written Word/Calibre-Bibliothek" } } } } Then ask Claude: "Find unread sci-fi books", "Open a random Banks novel", or "What's my library health?"

What is this?

calibre-mcp bridges your Calibre e-book library and AI assistants (Claude Desktop, Cursor, etc.) via the Model Context Protocol. It reads Calibre's metadata.db directly, indexes metadata for semantic search (LanceDB RAG), and exposes 33 portmanteau tools for natural-language library management.

Full Architecture & Technology Stack

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                                   CLIENT INTERFACES                                    │
│  ┌───────────────────────┐  ┌─────────────────────────┐  ┌──────────────────────────┐  │
│  │     Claude Desktop    │  │   Calibre MCP WebApp    │  │  Calibre GUI + Plugin    │  │
│  │   (MCP stdio / MCPB)  │  │  (Next.js 15 @ :10721)   │  │   (Qt6 / PyQt5 Plugin)   │  │
│  └───────────┬───────────┘  └────────────┬────────────┘  └────────────┬─────────────┘  │
└──────────────┼───────────────────────────┼────────────────────────────┼────────────────┘
               │ JSON-RPC (stdio)          │ REST / SSE                 │ Direct SQLite
               ▼                           ▼                            ▼
┌───────────────────────────────────────────────────────┐  ┌─────────────────────────────┐
│             CALIBRE-MCP BACKEND (:10720)              │  │    CALIBRE CONTENT SERVER   │
│                                                       │  │       (e.g. :8099)          │
│  ┌─────────────────────────────────────────────────┐  │  │                             │
│  │ FastMCP 3.2 Server + Tool Registry (21 tools)   │  │  │  - Async Python Engine      │
│  │ - Reciprocal Rank Fusion (RRF) Hybrid Search    │  │  │    (calibre.srv)            │
│  │ - Incremental LanceDB RAG Sync                  │  │  │  - RapydScript SPA          │
│  │ - Portmanteau CRUD & Library Health Engine      │  │  │    (index-generated.html)   │
│  └─────────────────────────────────────────────────┘  │  │  - HTML5 In-Browser Reader  │
│  ┌─────────────────────────────────────────────────┐  │  │    (viewer.js / offline SW) │
│  │ FastAPI REST Layer + Async Background Workers   │  │  │  - OPDS Mobile Catalog Feed │
│  └─────────────────────────────────────────────────┘  │  └──────────────┬──────────────┘
└──────────────┬───────────────────────────┬────────────┘                 │
               │                           │                              │
               ▼                           ▼                              ▼
┌──────────────────────────────┐  ┌──────────────────────────────────────────────────────┐
│       AI / VECTOR LAYER      │  │                   DATA STORAGE LAYER                 │
│  - LanceDB (Metadata & FTS)  │  │  - metadata.db (Calibre SQLite catalog)              │
│  - fastembed (BAAI/bge-small)│  │  - full-text-search.db (Calibre FTS5 token index)    │
│  - Ollama / OpenAI