Home › Design & Media › Audiobookshelf

Audiobookshelf

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

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.4.0)

npx -y audiobookshelf-mcp@0.4.0

Or add to your MCP client config:

{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "audiobookshelf-mcp@0.4.0"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_API_KEY": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_READ_ONLY": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_INSECURE_TLS": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_DENY_TOOLS": "<YOUR_VALUE>"
      }
    }
  }
}

AUDIOBOOKSHELF_URL required — Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
AUDIOBOOKSHELF_API_KEY required secret — API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
AUDIOBOOKSHELF_READ_ONLY — Set to true to register only the 29 read tools and no write tools
AUDIOBOOKSHELF_INSECURE_TLS — Set to true to accept self-signed certificates for this connection only
AUDIOBOOKSHELF_ALLOW_TOOLS — Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
AUDIOBOOKSHELF_DENY_TOOLS — Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left

Package (oci)

docker run -i --rm ghcr.io/ni-c/audiobookshelf-mcp:0.4.0

Or add to your MCP client config:

{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ni-c/audiobookshelf-mcp:0.4.0"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_API_KEY": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_READ_ONLY": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_INSECURE_TLS": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "<YOUR_VALUE>",
        "AUDIOBOOKSHELF_DENY_TOOLS": "<YOUR_VALUE>"
      }
    }
  }
}

AUDIOBOOKSHELF_URL required — Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
AUDIOBOOKSHELF_API_KEY required secret — API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
AUDIOBOOKSHELF_READ_ONLY — Set to true to register only the 29 read tools and no write tools
AUDIOBOOKSHELF_INSECURE_TLS — Set to true to accept self-signed certificates for this connection only
AUDIOBOOKSHELF_ALLOW_TOOLS — Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
AUDIOBOOKSHELF_DENY_TOOLS — Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left