calibre-library-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CALIBRE_SSH_KEY | No | SSH private key path. | |
| CALIBRE_SSH_HOST | Yes | Hostname or IP address of the Calibre server. | |
| CALIBRE_SSH_PORT | No | SSH port. Defaults to 22. | 22 |
| CALIBRE_SSH_USER | Yes | SSH user on the Calibre server. | |
| CALIBRE_DOCKER_IMAGE | No | Calibre image used for calibredb status checks. | lscr.io/linuxserver/calibre:latest |
| CALIBRE_WEB_CONTAINER | No | Container used to query the mounted library. Defaults to calibre-web. | calibre-web |
| CALIBRE_MAINTENANCE_SCRIPT | No | Optional remote script for refreshing FTS. | |
| CALIBRE_REMOTE_LIBRARY_PATH | No | Library path on the remote host for Calibre CLI status checks. | |
| CALIBRE_CONTAINER_BOOKS_PATH | No | Library path inside the container. Defaults to /books. | /books |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calibre_search_booksC | Search Calibre metadata by book title or author. |
| calibre_recent_booksC | List recently added books from the Calibre library. |
| calibre_book_detailsB | Get metadata, formats, and library file names for a Calibre book ID. |
| calibre_search_textC | Search extracted full text from indexed Calibre books and return snippets. |
| calibre_index_summaryA | Return raw full-text index row counts grouped by format. |
| calibre_index_statusA | Return Calibre's own full-text indexing status. |
| calibre_run_index_maintenanceA | Start the optional remote maintenance script that refreshes Calibre FTS. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: book details, two index reporting tools (status vs. summary), recent books, index maintenance, and two search tools (metadata vs. full text). No overlap or ambiguity.
All tools follow a consistent 'calibre_verb_noun' pattern using snake_case, making the naming predictable and easy to understand.
With 7 tools, the server is well-scoped for querying and maintaining a Calibre library. It's not overburdened with unnecessary tools nor lacking essential ones for its purpose.
The tool set covers core operations: getting book details, searching, listing recent books, and index maintenance. Missing a tool to list all books or filter by other criteria, but given the focus on search and indexing, this is a minor gap.