Notes & knowledge / CONNECTION GUIDECalibre MCP Server for Claude Code
A local MCP server reads a Calibre library and uses Calibre command-line tools for library changes.
Integration documentation MCP · Files & library
A local MCP server reads a Calibre library and uses Calibre command-line tools for library changes.
Platforms: Windows, macOS, Linux
Claude Code · Documented
The maintainer documents Claude Code setup for this connection.
Codex · MCP compatible
MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.
Cursor · MCP compatible
MCP transport compatibility is inferred; this agent is not explicitly documented for this connection.
Requirements and limitations
Python 3.12+, uv, a configured library path, and Calibre calibredb and ebook-convert on PATH.
Works on the library rather than clicking the GUI. Write operations follow the project’s confirmation and backup flow.
CLI · Files & library
The calibredb command-line tool manages a Calibre ebook library.
Platforms: Windows, macOS, Linux
Claude Code · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Codex · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Cursor · Not documented
The native interface is documented, but no setup for this coding agent is established by this source.
Requirements and limitations
Calibre command-line tools installed and a local library path or supported server connection.
Operates on library data rather than the GUI. Concurrent library access must follow Calibre’s documented constraints.
Compare connections
Compare how each route works, what it can do, and what you need to run it.
| Connection | Workflow and platform | Capabilities | Documented agents | Requirements and limitations |
|---|
Calibre MCP
MCP | Files & library
Windows, macOS, Linux | | Claude Code | Python 3.12+, uv, a configured library path, and Calibre calibredb and ebook-convert on PATH.
Works on the library rather than clicking the GUI. Write operations follow the project’s confirmation and backup flow. |
|---|
Calibre calibredb
CLI | Files & library
Windows, macOS, Linux | | See compatibility | Calibre command-line tools installed and a local library path or supported server connection.
Operates on library data rather than the GUI. Concurrent library access must follow Calibre’s documented constraints. |
|---|
How it works
MCP · Files & library
Windows, macOS, Linux
Capabilities
Search books and edit metadata · Add books and convert ebook formats
Documented agents
Claude Code
Requirements and limitations
Python 3.12+, uv, a configured library path, and Calibre calibredb and ebook-convert on PATH.
Works on the library rather than clicking the GUI. Write operations follow the project’s confirmation and backup flow.
How it works
CLI · Files & library
Windows, macOS, Linux
Capabilities
Search and update library metadata · Add and export books
Documented agents
See compatibility
Requirements and limitations
Calibre command-line tools installed and a local library path or supported server connection.
Operates on library data rather than the GUI. Concurrent library access must follow Calibre’s documented constraints.
Choose an AI agent
Claude Code + Calibre Codex: setup not listed in the integration documentation.
Cursor: setup not listed in the integration documentation.
Questions before setup
Does one integration cover every workflow?
No such claim is made. Check the capability list, requirements and limitations of each route, then test a copy of a representative project.