Calibre-Web MCP for AI. Query, Catalog, and Sync Your Private Book Library
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
Calibre-Web connects your AI client to your private digital library instance, letting you query and manage thousands of ebooks using natural language.
You can automatically discover catalog structures, list books from specific shelves, and prepare structured metadata for e-reader synchronization (Kobo).
What your AI can do
Sync kobo library
Generates structured metadata and secure download links necessary for synchronizing your library contents with Kobo devices.
Get opds catalog
Retrieves the primary, comprehensive XML feed that maps out your entire library's structure and categories.
Get opds shelf
Fetches the specific OPDS feed containing only the books belonging to a designated shelf ID number.
Retrieves the main OPDS feed, allowing your AI client to browse all categories, authors, and recent additions in your library.
Queries a defined shelf ID and returns a list of every book contained within that user-defined collection.
Fetches structured metadata and download links, specifically formatted for easy synchronization with Kobo devices.
Ask an AI about this
Waiting for input…
Calibre-Web: 3 Tools Available
Use these three tools to pull detailed book data, map out your library structure, or generate synchronization packages with simple commands.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Calibre-Web on VinkiusSync Kobo Library
Generates structured metadata and secure download links necessary for synchronizing your library contents with Kobo devices.
Get Opds Catalog
Retrieves the primary, comprehensive XML feed that maps out your entire library's...
Get Opds Shelf
Fetches the specific OPDS feed containing only the books belonging to a designated...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Calibre-Web, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Calibre-Web. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 3 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Checking a Library's Contents Used to Be a Pain Point.
Today, checking your book collection means clicking through category menus or exporting massive OPDS XML files just to confirm if books are grouped correctly. You spend time sifting through tags and IDs, copying data into spreadsheets, and praying the whole structure holds together when you need a quick list of titles.
With this MCP, natural language handles it. Instead of wrestling with web interfaces or file formats, your agent asks for what it needs—like 'What's on shelf 12?'—and gets an immediate, clean data response that tells you exactly what's there.
Accessing Structured Data via the Calibre-Web MCP
The manual process of gathering metadata for external use meant juggling multiple export options, ensuring your data was compatible with Kobo's specific requirements. You had to manually check token validity and format everything yourself.
Now, a single command handles it all. Running `sync_kobo_library` automatically structures the metadata and generates secure download links in one step. The complexity of e-reader synchronization disappears.
What your AI can actually do with this
Talking to a large book collection used to mean manually navigating complex websites or generating XML feeds just to see what's in it. Now, you treat your entire digital library like a searchable database. This MCP lets your agent interact with the full structure of your Calibre-Web instance using plain language commands.
You can ask for an overview of all categories or check exactly which books are on a specific curated shelf without ever touching a URL. Plus, if you use Kobo e-readers, the tool handles the metadata formatting and secure links needed to sync your collection directly. Connect this MCP via Vinkius and let your agent do the heavy lifting, giving you instant access to every piece of book data.
019e3873-2659-71f3-87e0-85aaed64d1e6 Here's how it actually works
The bottom line is that you talk naturally, and this MCP translates those requests into specific API calls to pull book data from your self-hosted instance.
First, subscribe to this MCP and provide your Calibre-Web instance URL along with any required credentials.
Next, tell your AI client what you need—for example, 'Show me the books on shelf ID 5' or 'Get the full catalog feed.'
The tool executes the request against your private library data and hands back structured metadata or a list of titles for your agent to process.
Who is this actually for?
This is for the digital librarian or academic who spends too much time manually verifying collection contents. If you manage large, curated libraries and need reliable ways to export metadata or check specific shelf integrity, this MCP saves hours of manual API work.
Uses get_opds_catalog to confirm the structural integrity of a collection before an audit. They also rely on get_opds_shelf to verify contents across multiple, segmented archival shelves.
Needs to quickly validate metadata for dozens of related works and uses the tool's capabilities to generate structured lists for external citation databases. They also utilize sync_kobo_library when transferring research copies to an e-reader.
Wants to automate book transfers or verify that a newly added collection segment is properly cataloged by running simple queries against the main OPDS feed and specific shelf IDs.
What Changes When You Connect
Stop manually copying XML feeds. You can ask your agent to run get_opds_catalog and instantly get a structured view of every category and author in your entire collection.
Need to check if the right books are on a specific shelf? Use get_opds_shelf. Just feed it the ID, and you get an instant list of contents without clicking through multiple web pages.
The tool handles e-reader preparation. Running sync_kobo_library automatically gathers all necessary metadata and direct download links for Kobo devices—no more manual exports.
It centralizes access. Your agent interacts with your library data as if it were a simple API, letting you bypass the need to learn Calibre-Web's specific web interface quirks.
Saves time on verification tasks. If you suspect metadata is wrong or a shelf is incomplete, running get_opds_shelf gives immediate proof of what's available.
See it in action
Auditing an academic collection
The librarian needs to confirm that all 50 books on the 'Victorian Poetry' shelf are present and correctly cataloged. Instead of running a complex manual query, they ask their agent to execute get_opds_shelf with the specific ID. The response provides an immediate list, letting them verify metadata integrity in seconds.
Preparing for a book fair display
An author needs to quickly show potential buyers that their best-selling series is properly cataloged and grouped. They use the agent to call get_opds_catalog, which pulls the main feed, allowing them to confirm the existence of the 'Series' category before building the physical display.
Mass transferring books to a client
A digital archivist needs to send a batch of research documents to a client using Kobo. They use sync_kobo_library, providing only their sync token, and the tool returns all the necessary structured data and direct download links needed for seamless transfer.
Verifying library structure after migration
A system admin migrated a large collection but can't remember the IDs. They use the agent to call get_opds_catalog first, which shows them all available categories. Then they follow up by asking the tool to check specific shelf IDs using get_opds_shelf, confirming the data moved correctly.
The honest tradeoffs
Trying to guess metadata
Manually navigating through Calibre-Web's web interface and trying to remember which section contains the specific book ID or shelf structure. It's a click-through mess.
Use get_opds_catalog first; it gives you the map of your entire library in one call. Then, if you know the target area, use get_opds_shelf to pull the precise list of books from that shelf ID.
Confusing cataloging with syncing
Attempting to use a standard database query when all they really need is Kobo-ready files. The data structure doesn't match what their e-reader expects.
Don't query the raw metadata directly. You must run sync_kobo_library. This tool formats and secures the output specifically for Kobo devices, guaranteeing compatibility.
Over-relying on one feed
Only checking the main catalog (get_opds_catalog) when you know a specific, small collection is miscategorized. The general view won't catch it.
Always supplement the wide view with narrow checks. Use get_opds_shelf and provide the exact shelf ID to ensure that curated or specialized collections are accounted for.
When It Fits, When It Doesn't
Use this MCP if your primary workflow involves inspecting, organizing, or exporting structured data from a self-hosted digital book collection. If you need to see the whole picture (categories and authors), run get_opds_catalog. If you know exactly which niche group of books you're dealing with, use get_opds_shelf for precision. Use sync_kobo_library only when your final destination is a Kobo device. Don’t use this if you just need to read the book—that’s the client app's job. Also, don't try to make it talk to other services; its sole function is exposing your internal Calibre-Web data.
Questions you might have
How do I check my entire book catalog using get_opds_catalog? +
You ask your agent to run get_opds_catalog. It pulls the main OPDS feed, which gives you a structured view of all categories and authors available in your library immediately.
What is the difference between get_opds_catalog and get_opds_shelf? +
The catalog tool gets the full map of everything. The shelf tool, get_opds_shelf, limits the output to only what belongs on a specific, curated shelf ID you name.
Do I need a Kobo token for sync_kobo_library? +
Yes, sync_kobo_library requires your dedicated Kobo Token. This ensures the generated metadata and download links are secure and usable by your e-reader device.
Can I use this MCP to search for a book title? +
The tool focuses on catalog structure, not free-text searching. You must first retrieve the list of titles using get_opds_catalog or get_opds_shelf, and then your agent can help you search that structured data.
What specific metadata fields does the `get_opds_catalog` tool return? +
It returns structured data covering key library elements, including titles, authors, publication dates, and associated shelf IDs. This allows your agent to understand both the book's details and where it lives within your collection.
What happens if I use `get_opds_shelf` with an invalid ID? +
The MCP will return a specific error message. This tells you that the requested shelf ID either doesn't exist or is inaccessible to your connected account, letting you pinpoint the problem quickly.
Are there any rate limits I should know about when running `sync_kobo_library`? +
While designed for typical use, repeated, large-scale syncs in quick succession might hit throttling limits imposed by Calibre-Web. If you encounter errors, try spacing out your synchronization requests.
Do I need to configure any specific credentials beyond the base URL? +
Yes. While the primary setup requires the instance URL, if your self-hosted Calibre-Web requires advanced authentication, you'll need to input additional username or API keys for full access.
Can I browse my entire library structure through the AI? +
Yes. By using the get_opds_catalog tool, the agent retrieves the root XML feed of your Calibre-Web instance, allowing it to see categories, authors, and series as defined in your OPDS settings.
How do I list books from a specific custom shelf? +
You can use the get_opds_shelf tool by providing the specific shelf_id. The AI will then return the list of books and metadata associated with that particular shelf.
Does this support syncing my Kobo e-reader? +
Yes. If you provide your CALIBRE_WEB_KOBO_TOKEN, you can use the sync_kobo_library tool to get structured metadata and download links specifically formatted for Kobo device synchronization.
We've already built the connector for Calibre-Web. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 3 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.