Home › Design & Media › Calibre-Web

Calibre-Web

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

TypeScript Local

★ 0 stars Last pushed 2026-09-22 License: MIT

View repository → Website →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.3.1)

npx -y calibreweb-mcp@0.3.1

Or add to your MCP client config:

{
  "mcpServers": {
    "calibreweb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "calibreweb-mcp@0.3.1"
      ],
      "env": {
        "CALIBRE_WEB_URL": "<YOUR_VALUE>",
        "CALIBRE_WEB_USERNAME": "<YOUR_VALUE>",
        "CALIBRE_WEB_PASSWORD": "<YOUR_VALUE>",
        "CALIBRE_WEB_INSECURE_TLS": "<YOUR_VALUE>",
        "CALIBRE_WEB_ALLOW_TOOLS": "<YOUR_VALUE>",
        "CALIBRE_WEB_DENY_TOOLS": "<YOUR_VALUE>"
      }
    }
  }
}

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

Package (oci)

docker run -i --rm ghcr.io/ni-c/calibreweb-mcp:0.3.1

Or add to your MCP client config:

{
  "mcpServers": {
    "calibreweb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/calibreweb-mcp:0.3.1"
      ],
      "env": {
        "CALIBRE_WEB_URL": "<YOUR_VALUE>",
        "CALIBRE_WEB_USERNAME": "<YOUR_VALUE>",
        "CALIBRE_WEB_PASSWORD": "<YOUR_VALUE>",
        "CALIBRE_WEB_INSECURE_TLS": "<YOUR_VALUE>",
        "CALIBRE_WEB_ALLOW_TOOLS": "<YOUR_VALUE>",
        "CALIBRE_WEB_DENY_TOOLS": "<YOUR_VALUE>"
      }
    }
  }
}

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