calibreweb-mcp

Appearance

calibreweb-mcpYour ebook library, spoken to

A read-only MCP server for Calibre-Web: search the library, browse views and shelves, pull covers and download links — from Claude, Codex or any MCP client.

Get started
Tools reference
GitHub

  • The API Calibre-Web never had

    Calibre-Web exposes no REST API — its only stable machine interface is the OPDS Atom feed built for e-reader apps. These tools parse that feed into structured book data with numeric ids, per-format download URLs and bounded summaries.

  • Runs anywhere stdio does

    A single npx command, a Claude Desktop JSON block, a Codex TOML entry, or a multi-arch container image with an SBOM and build provenance.

  • Read-only by construction

    Six tools, all GET. Redirects are refused so Basic credentials never travel, XML with a DOCTYPE is rejected outright, hrefs are locked to the configured origin, and metadata is marked as the untrusted data it is.

calibreweb-mcp architectureAn MCP client speaks stdio to calibreweb-mcp, which reads the OPDS feed of Calibre-Web over HTTPS with Basic auth; Calibre-Web serves the Calibre library.MCP clientClaude, Codex, Inspectorcalibreweb-mcp6 read-only toolsCalibre-Web/opds Atom feedCalibre librarybooks, covers, shelvesstdioHTTPSBasic authhardened XML · bounded responses · GET only
The server holds no state at all: every tool call is a GET against the OPDS routes, and Calibre-Web remains the source of truth for the Calibre library behind it.

See it run ​

Demo: listing the tools, searching the library and reading the stats through the MCP Inspector CLI

Released under the MIT License.

Copyright © 2026 Willi Thiel