Vinkius
Calibre-Web

Calibre-Web MCP for AI. Query, Catalog, and Sync Your Private Book Library

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Calibre-Web MCP on Cursor AI Code EditorCalibre-Web MCP on Claude Desktop AppCalibre-Web MCP on OpenAI Agents SDKCalibre-Web MCP on Visual Studio CodeCalibre-Web MCP on GitHub Copilot AI AgentCalibre-Web MCP on Google Gemini AICalibre-Web MCP on Lovable AI DevelopmentCalibre-Web MCP on Mistral AI AgentsCalibre-Web MCP on Amazon AWS Bedrock

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.

Discovering full catalog structure

Retrieves the main OPDS feed, allowing your AI client to browse all categories, authors, and recent additions in your library.

Listing contents of specific shelves

Queries a defined shelf ID and returns a list of every book contained within that user-defined collection.

Generating sync files for e-readers

Fetches structured metadata and download links, specifically formatted for easy synchronization with Kobo devices.

Included with Plan

Waiting for input…

AI Agent

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 Vinkius

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...

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.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Calibre-Web integration is available immediately — no restart needed.

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
Start building

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
Calibre-Web MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius Calibre-Web MCP - Inspect Digital Library Structure
Server ID 019e3873-2659-71f3-87e0-85aaed64d1e6
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.

Built & Managed by Vinkius 30s setup 3 tools

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 runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

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.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.