# Calibre-Web MCP for AI Agents AI Agent Connect

> Calibre-Web MCP lets you talk to your personal ebook library using your AI agent. It handles browsing your OPDS catalog, searching specific shelves, and pulling metadata for Kobo device syncs. If you host your own books, this connects your collection directly to your chat interface.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/ai-agent-connect
- **Tags:** ebooks, calibre, opds, kobo-sync, digital-library

## Description

The Calibre-Web MCP connects your personal ebook library to your AI agent so you can interact with your collection using natural language. Managing a library of thousands of titles usually feels like a chore. You have to open your browser, log into your Calibre-Web instance, and then hunt through dozens of categories just to find that one specific title you remembered reading last month. It's a lot of friction for a simple search. This Connector changes that by letting your agent do the heavy lifting. Instead of manual browsing, you can just ask your agent to find a specific book or list everything on a certain shelf. It pulls data directly from your Calibre-Web instance, so the information is always current. If you use a Kobo e-reader, it handles the part of gathering sync tokens and metadata to get your books onto your device. You can link your Calibre-Web instance to your AI client through the Vinkius catalog and get your agent connected in minutes. It turns your static library into a searchable database where you can find exactly what you need without opening a browser tab. It makes your digital collection feel like a smart, accessible library that responds to your requests immediately.

## Tools

### get_opds_shelf
Retrieves the OPDS feed for a specific shelf. It helps you focus on curated collections like 'To Read' or 'Favorites'.

### sync_kobo_library
Pulls structured metadata and secure download links for your Kobo device. It makes syncing your library much faster.

### get_opds_catalog
Fetches the main OPDS XML feed to show your library's categories. Use it to see your whole collection at once.

## Prompt Examples

**Prompt:** 
```
Show me the books on my 'Favorites' shelf.
```

**Response:** 
```
I've checked your shelf and found 4 books:

* **Dune**
* **Foundation**
* **Neuromancer**
* **The Hobbit**

Would you like the download links for any of these?
```

**Prompt:** 
```
What's in my library right now?
```

**Response:** 
```
I've accessed your Calibre-Web feed. You have 4 categories:

| Category | Status |
| :--- | :--- |
| Sci-Fi | Active |
| Non-Fiction | Active |
| Classics | Active |
| To Read | Active |

Which one should we look at?
```

**Prompt:** 
```
Get my Kobo library ready.
```

**Response:** 
```
I'm pulling the metadata for your Kobo sync. I found 15 books ready to go. I've generated the direct download links for your device.
```

## Capabilities

### Browse your entire library structure
See all your categories and recent additions in one view.

### List books from specific curated shelves
Query specific shelf IDs to see books in custom collections.

### Generate Kobo sync metadata
Fetch the structured data and download links for your Kobo device.

### Search for specific book entries
Find specific titles and metadata within your self-hosted collection.

### Retrieve the main OPDS feed
Get the full XML feed to browse your entire library layout.

## Use Cases

### Finding a specific title
A user asks for a book by a specific author and the agent finds it in the catalog.

### Kobo syncing
A reader wants to move 20 books to their Kobo and the agent pulls the download links automatically.

### Shelf auditing
A librarian wants to see what's on their 'Favorites' shelf and uses the shelf feed to check the list.

### Library exploration
A new user wants to see what categories are available and asks for the main feed.

## Benefits

- Stop scrolling through long lists by using the catalog fetch to see your entire library structure instantly.
- Organize your reading habits by querying specific shelf IDs to see curated collections.
- Save time on device management by pulling the metadata and download links for your e-reader faster.
- Find specific titles in seconds by letting your agent search your metadata directly.
- Keep your digital library organized by verifying shelf contents through a simple chat interface.

## How It Works

The bottom line is you get a chat interface for your private ebook collection.

1. Subscribe to the Calibre-Web MCP on Vinkius.
2. Provide your Calibre-Web instance URL and credentials.
3. Ask your AI agent to show you a specific shelf or sync your Kobo library.

## Frequently Asked Questions

**Can the Calibre-Web MCP find books in my private collection?**
Yes, it connects to your self-hosted instance to let your agent browse your specific books, categories, and shelves.

**How does the Calibre-Web MCP help with my Kobo e-reader?**
It fetches the metadata and download links you need to sync your books to your Kobo device automatically.

**Do I need to have a Calibre-Web account?**
You need a Calibre-Web instance running. The Connector connects to that specific URL using the credentials you provide.

**Can I use the Calibre-Web MCP to see my different book shelves?**
Yes, you can ask your agent to list books from any specific shelf ID in your library.

**Will the Calibre-Web MCP search the whole internet for books?**
No, it only searches the books you have already added to your personal Calibre-Web library.

**Is my library data private?**
Yes, the connection happens between your AI client and your own Calibre-Web instance.

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