Calibre-Web MCP server
Read-only MCP server for Calibre-Web: library search, browsing and covers via the OPDS feed
0 stars61 downloads/wk
Reviews
Write oneNobody has reviewed Calibre-Web yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Calibre-Web tools (6)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_coverFetches the cover of a book and returns it as an image. Book ids come
get_shelf_booksLists the books on a shelf, in the shelf’s own order. Shelf ids
get_statsReturns the total number of books, authors, categories (tags) and
list_booksLists books from one of the Calibre-Web views: new (recently added,
list_shelvesLists the shelves visible to the configured user: every public shelf
search_booksSearches the library by title, author, series, publisher and tags.
Public scan report
scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it
- Code scan27 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Calibre-Web compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 70% of 3,470 Web search servers
- Tools
- 6
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 61
- more than 43% of 827 Web search servers with a package
What its tools let an agent do: 6 read
Install Calibre-Web in Claude Code, Cursor or VS Code
Runs npx -y calibreweb-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add calibreweb-mcp -- npx -y calibreweb-mcp
What the publisher says
From the Calibre-Web repository's README, as published. We do not edit it. Read it on GitHub
calibreweb-mcp
<!-- badges: start -->
<!-- badges: end -->
A read-only Model Context Protocol (MCP) server for Calibre-Web (and Calibre-Web Automated), the self-hosted ebook library web UI.
Lets MCP clients like Claude Code, Claude Desktop or Codex search your library, browse the curated views and shelves, follow per-format download links and pull cover images straight into the conversation. It never writes anything: every tool is a GET.
Six tools is the ceiling, not the floor: CALIBREWEBALLOW_TOOLS=essential registers a curated five instead, and a model picks the right tool far more reliably from five than from six — see choosing which tools load.
Calibre-Web has no REST API — its only stable machine-readable interface is the OPDS catalog feed it serves for e-reader apps. This server speaks that feed: Atom XML with HTTP Basic auth in, structured book data out.
<!-- is resolved against the colour scheme of the page showing it, so GitHub picks the variant that matches its own theme toggle. npm strips and when it sanitises the README and keeps the , which is why that fallback brings its own dark card instead of relying on a media query. -->
<!-- Recorded with vhs from docs/demo.tape against the bundled fixture library (docs/demo-server.mjs) — no Calibre-Web instance needed to reproduce it. -->
What makes it different
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.
Read-only by construction. All six tools are GETs. Redirects are refused so Basic credentials never travel, XML carrying a DOCTYPE is rejected outright, hrefs are locked to the configured origin, and metadata is marked as the untrusted data it is.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Calibre-Web: common questions
- Is Calibre-Web MCP server safe?
- Mostly: it is graded B (83/100). Read the Calibre-Web safety report
- How do I install Calibre-Web?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Calibre-Web need an API key?
- Yes. The registry entry asks for
CALIBRE_WEB_PASSWORD. - Is Calibre-Web maintained?
- The last commit was 20 days ago (2026-10-15). The latest release is v0.3.1.
- What can I use instead of Calibre-Web?
- Servers from other publishers that do the same job: Zotero MCP server, Calibre MCP server and Perplexity API Platform (moved to ai.perplexity/mcp-server).
- How does Calibre-Web compare with other Web search MCP servers?
- safety score 83/100 (higher than 70% of 3,470 Web search servers); tools 6 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Calibre-Web
Same job from other publishers: the closest match first, then the best rated.
Zotero MCPSearch, read, annotate, and add to your Zotero research library, local or web.not reviewedWidely usedB- CalibreCalibre ebook library server: search, read content, curate metadata, semantic search, gated writes.not reviewedGrowingA
- Perplexity API Platform (moved to ai.perplexity/mcp-server)Real-time web search, reasoning, and research through Perplexity's APInot reviewedWidely usedA
- TavilyMCP server for advanced web search using Tavilynot reviewedWidely usedA
- SearchMCP server for web search operationsnot reviewedEstablishedA