NestDaddy

Audiobookshelf

io.github.ni-c/audiobookshelf-mcp ยท v0.4.0

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

Connect Runs on your machine

Terminal
claude mcp add audiobookshelf-mcp -e AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL> -e AUDIOBOOKSHELF_API_KEY=<AUDIOBOOKSHELF_API_KEY> -e AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY> -e AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS> -e AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS> -e AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
        "AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>",
        "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
        "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
        "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
        "AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>",
        "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
        "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
        "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "audiobookshelf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
        "AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>",
        "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
        "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
        "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
        "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
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
Optional
Set to true to register only the 29 read tools and no write tools
AUDIOBOOKSHELF_INSECURE_TLS
Optional
Set to true to accept self-signed certificates for this connection only
AUDIOBOOKSHELF_ALLOW_TOOLS
Optional
Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
AUDIOBOOKSHELF_DENY_TOOLS
Optional
Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left

Details

Package[email protected] (NPM, stdio)
Packageghcr.io/ni-c/audiobookshelf-mcp:0.4.0 (OCI, stdio)
First published7 Sep 2026
Last updated7 Sep 2026
Registry nameio.github.ni-c/audiobookshelf-mcp

More other servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.