Skip to main content
Glama
mmccarthy404

calibre-mcp

by mmccarthy404

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)

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

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

List/browse the library, sorted.

get_book(book_id)

Full metadata for one book by its Calibre ID.

list_recent(limit=10)

Most recently added books.

Related MCP server: Calibre RAG 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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mmccarthy404/calibre-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server