Skip to main content
Glama
Sign In
calibre-mcp

calibre-mcp

by mmccarthy404
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

calibre-mcp

A minimal, read-only Model Context Protocol server for a local Calibre e-book library. It wraps the calibredb CLI (--for-machine JSON output), so it needs no content server and cannot modify your library — no write tools exist.

Defaults target Windows, but it runs anywhere calibredb does (macOS/Linux) — just set the two environment variables below.

Tools

Tool

Description

search_books(query, limit=20, offset=0)

Search using Calibre's search syntax (e.g. author:Erikson, tag:Fantasy, series:"Malazan"); page with offset.

list_books(limit=50, offset=0, sort_by="timestamp", ascending=False)

List/browse the library, sorted; page through it with offset.

get_book(book_id)

Full metadata for one book by its Calibre ID.

list_recent(limit=10)

Most recently added books.

count_books()

Total number of books in the library.

Related MCP server: Calibre MCP Server

Requirements

  • Calibre installed (provides calibredb).

  • uv to manage the environment.

Install

git clone https://github.com/mmccarthy404/calibre-mcp.git
cd calibre-mcp
uv sync

Configuration

Set via environment variables (Windows defaults shown; change to your paths):

Variable

Default

Notes

CALIBRE_LIBRARY_PATH

D:\Documents\Calibre Library

Path to your Calibre library folder (contains metadata.db).

CALIBREDB_PATH

C:\Program Files\Calibre2\calibredb.exe

Path to calibredb (on macOS/Linux, usually just calibredb).

Run

uv run calibre-mcp        # or: uv run python calibre_mcp.py

Register with Claude Code

claude mcp add calibre --scope user -- \
  uv run --directory "/path/to/calibre-mcp" python calibre_mcp.py

Then, in a new Claude session, ask things like "search my Calibre library for Erikson" or "what are my 5 most recently added books?".

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Neolibrarian MCP

      pshap
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables read-only access to local Calibre libraries for searching metadata, inspecting book formats, and extracting content samples. Supports full-text search, batch operations, and detailed book analysis through natural language queries.
      3
      MIT

    • Calibre MCP Server

      Miguel0888
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with research capabilities for local Calibre e-book libraries, including fulltext search across titles, ISBNs, and comments, plus structured excerpt retrieval from books.
      2
      GPL 3.0

    • calibre-mcp

      2b3pro
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching, reading, and managing a Calibre ebook library through natural language, with features like metadata search, full-text search, content extraction, and library management.
      474 npm
      Apache 2.0