Calibre-Web Connector for AI agents.
3 live capabilities
Manage your personal ebook library and Kobo sync via chat.
Waiting for input…
Why people use Calibre-Web
Calibre-Web Ebook Library Management for AI Agents
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 you get your answer in seconds without ever leaving your chat window.
What Vinkius changes
You get a chat interface for your private ebook collection.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding a specific title
A user asks for a book by a specific author and the agent finds it in the catalog.
- Real-world use case 02
Kobo syncing
A reader wants to move 20 books to their Kobo and the agent pulls the download links automatically.
- Real-world use case 03
Shelf auditing
A librarian wants to see what's on their 'Favorites' shelf and uses the shelf feed to check the list.
Complete set · 3capabilities
The complete Calibre-Web capability set.
These are the exact actions your AI can choose when you ask it to work with Calibre-Web.
01—03
3 capabilities in this set.
Part of 3 available through Calibre-Web.
- 01 Capability
Get opds shelf
Retrieves the OPDS feed for a specific shelf. It helps you focus on curated collections like 'To Read' or 'Favorites'.
- 02 Capability
Sync kobo library
Pulls structured metadata and secure download links for your Kobo device. It makes syncing your library much faster.
- 03 Capability
Get opds catalog
Fetches the main OPDS XML feed to show your library's categories. Use it to see your whole collection at once.
Set up in minutes
One URL. Then ask Calibre-Web to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Calibre-Web from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Calibre-Web, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Calibre-Web for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Calibre-Web URL.
- Step 03
Save and start
Save the connection and enable Calibre-Web in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"calibre-web": {
"url": "https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Calibre-Web
Open Agent mode in chat and ask: "Using Calibre-Web, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"calibre-web": {
"url": "https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Calibre-Web
Ask Copilot: "Using Calibre-Web, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"calibre-web": {
"url": "https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Calibre-Web
Open Cascade and ask: "Using Calibre-Web, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"calibre-web": {
"url": "https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Calibre-Web
Ask Cline: "Using Calibre-Web, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add calibre-web --transport http "https://edge.vinkius.com/vk_preview_hRedSJB5J90CGp8awAuMgjxWwIuqFDQ7SBwMKw7J/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Calibre-Web
Ask Claude: "Using Calibre-Web, show me...". 3 tools are ready
Where the request belongs
Work Calibre-Web can move forward.
This is for heavy readers who have large collections and hate manual searching. It's for the digital librarian who wants to organize their collection via chat and the Kobo owner who wants to automate their device sync.
Avid Reader
Finds specific titles in a 5,000+ book collection in seconds.
Digital Librarian
Manages shelf contents and audits catalog structures via natural language.
Kobo Power User
Automates the metadata retrieval process for e-reader syncing.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsOverDrive Library API
Search library collections. audit books, formats, and media via AI.
Kavita (eBook/Manga)
Manage your Kavita media server—scan libraries, check API status, and authenticate sessions directly from your AI agent.
MIT Open Library
Access millions of books, read them online, and explore the world largest open catalog of bibliographic data for every title.
Gutendex
Search and discover 70,000+ free public domain ebooks from Project Gutenberg. no API key required.
Open Library
Manage your book discovery. audit library records, authors, and subjects via AI.
Google Books
Search the world's most comprehensive index of full-text books, manage personal bookshelves, and retrieve detailed literary metadata.
Bring your own AI
Change the model, client or framework. Keep Calibre-Web connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Calibre-Web.
The practical details behind the request, access and result.
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 capability, 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 capability 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 capability to get structured metadata and download links specifically formatted for Kobo device synchronization.
One connection away
Give your agent a direct line to Calibre-Web.
Connect Calibre-Web once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available