Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync
Connect Runs on your machine
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]
{
"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>"
}
}
}
}
{
"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>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
AUDIOBOOKSHELF_URLRequired | Base URL of the Audiobookshelf instance, e.g. https://abs.example.com |
AUDIOBOOKSHELF_API_KEYRequired, secret | API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer) |
AUDIOBOOKSHELF_READ_ONLYOptional | Set to true to register only the 29 read tools and no write tools |
AUDIOBOOKSHELF_INSECURE_TLSOptional | Set to true to accept self-signed certificates for this connection only |
AUDIOBOOKSHELF_ALLOW_TOOLSOptional | Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools) |
AUDIOBOOKSHELF_DENY_TOOLSOptional | Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left |
Details
| Package | [email protected] (NPM, stdio) |
| Package | ghcr.io/ni-c/audiobookshelf-mcp:0.4.0 (OCI, stdio) |
| First published | 7 Sep 2026 |
| Last updated | 7 Sep 2026 |
| Registry name | io.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.
