Skip to main content
Glama

Calibre MCP Server

by ispyridis
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

Prerequisites

  • Node.js >= 16.0.0

  • Calibre installed on Windows

Installation

  1. Clone this repository:

git clone https://github.com/yourusername/calibre-mcp-nodejs.git cd calibre-mcp-nodejs

  1. Install dependencies:

npm install

Usage

Starting the Server

npm start

Available Tools

  • search: Search for books in your Calibre library

  • fetch: 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 file

Testing

Run the test:

npm test

Or use the Windows batch file:

test.bat

Troubleshooting

Common Issues

  1. Calibre Not Found: Ensure Calibre is installed in a standard location

  2. Library Access: Make sure the Calibre library is accessible and not locked

  3. Permissions: Run with appropriate permissions to access Calibre files

Debug Mode

Set the DEBUG environment variable for verbose logging:

set DEBUG=calibre:* npm start

Supported 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

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests for new functionality

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

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables searching and reading books from your Calibre ebook library through MCP. Supports title, author, and full-text search across multiple formats with lightweight Windows-optimized implementation.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Starting the Server
          2. Available Tools
          3. Example MCP Configuration
        2. Configuration
          1. API Reference
            1. Search Books
            2. Fetch Book Content
          2. Project Structure
            1. Testing
              1. Troubleshooting
                1. Common Issues
                2. Debug Mode
              2. Supported Formats
                1. Performance
                  1. Comparison with RAG Version
                    1. Contributing
                      1. License
                        1. Support
                          1. Changelog
                            1. v2.0.0
                            2. v1.0.0

                          New MCP Servers

                          MCP directory API

                          We provide all the information about MCP servers via our MCP API.

                          curl -X GET 'https://glama.ai/api/mcp/v1/servers/ispyridis/calibre-mcp-nodejs'

                          If you have feedback or need assistance with the MCP directory API, please join our Discord server