Calibre MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Calibre MCP Server search for books by Stephen King published after 2010"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Calibre MCP Server
A lightweight Node.js MCP server for searching and reading books from your Calibre ebook library. Designed specifically for Windows compatibility.
Features
Library Search: Search your Calibre library by title, author, or content
Book Reading: Retrieve and read book contents in various formats
Metadata Access: Get detailed book information and metadata
Windows Compatible: Optimized for Windows environments
Zero Dependencies: Lightweight implementation with no external dependencies
Related MCP server: calibre-mcp
Prerequisites
Node.js >= 16.0.0
Calibre installed on Windows
Installation
Clone this repository:
git clone https://github.com/yourusername/calibre-mcp-nodejs.git
cd calibre-mcp-nodejsInstall dependencies:
npm installUsage
Starting the Server
npm startAvailable Tools
search: Search for books in your Calibre libraryfetch: Retrieve specific content from books using epub:// URLs
Example MCP Configuration
Add to your MCP client configuration:
{
"mcpServers": {
"calibre": {
"command": "node",
"args": ["path/to/calibre-mcp-nodejs/server.js"]
}
}
}Configuration
The server automatically detects your Calibre library location. The search looks for Calibre in common installation paths:
C:\Program Files\Calibre2\C:\Program Files (x86)\Calibre2\Custom paths via environment variables
API Reference
Search Books
// Search by title
search({ query: "title:\"The Great Gatsby\"" })
// Search by author
search({ query: "author:\"F. Scott Fitzgerald\"" })
// Full-text search
search({ query: "green light" })Fetch Book Content
// Fetch specific book content
fetch({ url: "epub://book_id/chapter_1" })Project Structure
calibre-mcp-nodejs/
├── server.js # Main MCP server
├── package.json # Dependencies and scripts
├── test.js # Test file
├── test.bat # Windows test script
└── README.md # This fileTesting
Run the test:
npm testOr use the Windows batch file:
test.batTroubleshooting
Common Issues
Calibre Not Found: Ensure Calibre is installed in a standard location
Library Access: Make sure the Calibre library is accessible and not locked
Permissions: Run with appropriate permissions to access Calibre files
Debug Mode
Set the DEBUG environment variable for verbose logging:
set DEBUG=calibre:*
npm startSupported Formats
The server supports all formats that Calibre can handle:
EPUB
PDF
MOBI
AZW/AZW3
TXT
HTML
And many more
Performance
This lightweight server is designed for:
Fast startup times
Low memory usage
Quick search responses
Minimal system impact
Comparison with RAG Version
This is the lightweight version. For advanced features like vector search, semantic similarity, and RAG capabilities, see calibre-rag-mcp-nodejs.
Feature | Simple Version | RAG Version |
Basic Search | ✅ | ✅ |
Book Reading | ✅ | ✅ |
Dependencies | None | Many |
Memory Usage | Low | High |
Vector Search | ❌ | ✅ |
Semantic Search | ❌ | ✅ |
OCR Support | ❌ | ✅ |
Project Organization | ❌ | ✅ |
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Submit a pull request
License
Licensed under the Apache License 2.0. See LICENSE file for details.
Support
For issues and questions, please open an issue on GitHub.
Changelog
v2.0.0
Improved Windows compatibility
Enhanced search functionality
Better error handling
Optimized performance
v1.0.0
Initial release
Basic search and fetch functionality
Windows support
Available Tools
2 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: 'fetch' retrieves specific content from a book using an epub URL, while 'search' performs library-wide queries for books. There is no overlap in functionality, making it impossible to confuse them.
Both tool names follow a simple, consistent verb pattern ('fetch' and 'search') that clearly indicates their actions. The naming is straightforward and predictable across the set.
With only 2 tools, this server feels severely under-scoped for managing an ebook library. Essential operations like adding books, updating metadata, deleting entries, or listing books are missing, making it incomplete for typical Calibre workflows.
The toolset is highly incomplete for ebook library management. While 'fetch' and 'search' are useful, there are significant gaps: no CRUD operations for books (create, read, update, delete), no library organization tools, and no metadata management beyond search. This will cause agent failures in common tasks.
Maintenance
Related MCP Connectors
Books MCP — wraps Open Library API (free, no auth)
Access Sefaria's library of Jewish texts, commentaries, and learning schedules via MCP
Query your own PDFs and documents from any MCP client. Every answer cites the page it came from.
MCP server for Project Gutenberg: 78,000+ public-domain ebooks with full plain-text retrieval.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables semantic search over local Calibre libraries via MCP, allowing AI assistants to query books, annotations, and export bibliographies while keeping data private.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables conversational management of a Calibre ebook library via MCP, including search, metadata editing, adding, converting, deduplicating, removing, and emailing books with human-in-the-loop safety.1MIT
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server for an existing Calibre ebook library, enabling metadata search, full-text search, and category browsing via the Model Context Protocol.1MIT
- AlicenseAqualityBmaintenanceConnects MCP clients to a Calibre ebook library for semantic search, metadata curation, and library management via natural language.19590 npm31MIT