English Français العربية

Calibre-Web

Official registry Search and web

Read-only MCP server for Calibre-Web: library search, browsing and covers via the OPDS feed

Source code Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package calibreweb-mcp
Claude Code 
claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- npx -y calibreweb-mcp@0.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "calibre-web": {
            "command": "npx",
            "args": [
                "-y",
                "calibreweb-mcp@0.3.1"
            ],
            "env": {
                "CALIBRE_WEB_URL": "<CALIBRE_WEB_URL>",
                "CALIBRE_WEB_USERNAME": "<CALIBRE_WEB_USERNAME>",
                "CALIBRE_WEB_PASSWORD": "<your calibre_web_password>",
                "CALIBRE_WEB_INSECURE_TLS": "<CALIBRE_WEB_INSECURE_TLS>",
                "CALIBRE_WEB_ALLOW_TOOLS": "<CALIBRE_WEB_ALLOW_TOOLS>",
                "CALIBRE_WEB_DENY_TOOLS": "<CALIBRE_WEB_DENY_TOOLS>"
            }
        }
    }
}

Environment variables

  • CALIBRE_WEB_URL required Root URL of the Calibre-Web instance, e.g. https://books.example.com
  • CALIBRE_WEB_USERNAME Username of the Calibre-Web account (web login); leave unset together with the password for anonymous-browsing instances
  • CALIBRE_WEB_PASSWORD secret Password of that account (web login password)
  • CALIBRE_WEB_INSECURE_TLS Set to true to accept self-signed certificates (scoped to the configured host)
  • CALIBRE_WEB_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • CALIBRE_WEB_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever CALIBRE_WEB_ALLOW_TOOLS left
OCI package ghcr.io/ni-c/calibreweb-mcp:0.3.1
Claude Code 
claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- docker run -i --rm ghcr.io/ni-c/calibreweb-mcp:0.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "calibre-web": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ni-c/calibreweb-mcp:0.3.1"
            ],
            "env": {
                "CALIBRE_WEB_URL": "<CALIBRE_WEB_URL>",
                "CALIBRE_WEB_USERNAME": "<CALIBRE_WEB_USERNAME>",
                "CALIBRE_WEB_PASSWORD": "<your calibre_web_password>",
                "CALIBRE_WEB_INSECURE_TLS": "<CALIBRE_WEB_INSECURE_TLS>",
                "CALIBRE_WEB_ALLOW_TOOLS": "<CALIBRE_WEB_ALLOW_TOOLS>",
                "CALIBRE_WEB_DENY_TOOLS": "<CALIBRE_WEB_DENY_TOOLS>"
            }
        }
    }
}

Environment variables

  • CALIBRE_WEB_URL required Root URL of the Calibre-Web instance, e.g. https://books.example.com
  • CALIBRE_WEB_USERNAME Username of the Calibre-Web account (web login); leave unset together with the password for anonymous-browsing instances
  • CALIBRE_WEB_PASSWORD secret Password of that account (web login password)
  • CALIBRE_WEB_INSECURE_TLS Set to true to accept self-signed certificates (scoped to the configured host)
  • CALIBRE_WEB_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • CALIBRE_WEB_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever CALIBRE_WEB_ALLOW_TOOLS left

Frequently asked questions

What is Calibre-Web?

Read-only MCP server for Calibre-Web: library search, browsing and covers via the OPDS feed

How do I install Calibre-Web?

It runs on your machine. In Claude Code: claude mcp add calibre-web -e 'CALIBRE_WEB_URL=<CALIBRE_WEB_URL>' -e 'CALIBRE_WEB_USERNAME=<CALIBRE_WEB_USERNAME>' -e 'CALIBRE_WEB_PASSWORD=<your calibre_web_password>' -e 'CALIBRE_WEB_INSECURE_TLS=<CALIBRE_WEB_INSECURE_TLS>' -e 'CALIBRE_WEB_ALLOW_TOOLS=<CALIBRE_WEB_ALLOW_TOOLS>' -e 'CALIBRE_WEB_DENY_TOOLS=<CALIBRE_WEB_DENY_TOOLS>' -- npx -y calibreweb-mcp@0.3.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Calibre-Web need an API key?

Yes. It expects CALIBRE_WEB_URL, CALIBRE_WEB_PASSWORD, which you set in its configuration.

Is Calibre-Web open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Calibre-Web?

It is published by ni-c. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.