Pergamos is a read-only MCP server that lets Claude Desktop search and inspect a Calibre library through the Calibre Content Server.
pergamos is an MCP project maintained in the gonzalochief/pergamos repository. The maintainer describes its purpose as “Pergamos is a read-only MCP server that lets Claude Desktop search and inspect a Calibre library through the Calibre Content Server”. Read the project documentation for the complete scope.
The project provides a local client configuration using /path/to/pergamos/.venv/bin/pergamos. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares CALIBRE_SERVER_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_libraries | checks the server and returns the root OPDS feed. |
| search_books | performs a Calibre library-wide search across the metadata fields indexed by Calibre, including titles, authors, tags, comments, and identifiers. It accepts… |
| list_all_books | returns all books in the library by title and metadata without a search query, which is useful for research planning and later indexing work. |
| get_book_details | returns metadata and available format links for a Calibre book identifier. |
| index_book_content | downloads a selected book file, extracts the text, splits it into chunks, and stores the embeddings for semantic retrieval. |
| search_book_content | searches the indexed text chunks for one or more book IDs using a semantic query. |
| list_indexed_books | returns the books currently present in the local vector store, including title, format, and chunk counts. |
| delete_book_index | removes all indexed chunks for a single Calibre book ID, useful for re-indexing or cleanup. |
| refresh_book_index | deletes stale chunks for a book and reindexes the current file so the content store stays fresh without a full rebuild. |
| rag_search_library | runs the metadata search and content search in one call, returning both the book hits and any matching indexed chunks. |
{
"mcpServers": {
"pergamos-calibre": {
"command": "/path/to/pergamos/.venv/bin/pergamos",
"env": {
"CALIBRE_SERVER_URL": "http://127.0.0.1:8080"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| CALIBRE_SERVER_URL | Declared in the maintainer’s client configuration. | Check documentation |
Official Redis server — search keys, inspect data structures and manage caches in natural language.
Enables AI agents and LLMs to interact with the web and extract information from web pages via the RAG Web Browser Actor.
Enables semantic search and retrieval of documentation using a vector database, allowing users to add and query documentation from URLs or local
Augments AI responses with relevant documentation context through vector search.
Augment AI responses with context by retrieving and processing documentation through vector search.
Enables semantic analysis of chat conversations through vector embeddings and knowledge graphs.