Audiobookshelf
Browse your Audiobookshelf libraries and keep listening progress, bookmarks and…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 5 days ago
About Audiobookshelf
Audiobookshelf is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync
Install
Run in a terminal
claude mcp add audiobookshelf-mcp --env AUDIOBOOKSHELF_URL='<AUDIOBOOKSHELF_URL>' --env AUDIOBOOKSHELF_API_KEY='<AUDIOBOOKSHELF_API_KEY>' -- npx -y audiobookshelf-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"audiobookshelf-mcp": {
"command": "npx",
"args": [
"-y",
"audiobookshelf-mcp"
],
"env": {
"AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
"AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"audiobookshelf-mcp": {
"command": "npx",
"args": [
"-y",
"audiobookshelf-mcp"
],
"env": {
"AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
"AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"audiobookshelf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"audiobookshelf-mcp"
],
"env": {
"AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
"AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"audiobookshelf-mcp": {
"command": "npx",
"args": [
"-y",
"audiobookshelf-mcp"
],
"env": {
"AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
"AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"audiobookshelf-mcp": {
"command": "npx",
"args": [
"-y",
"audiobookshelf-mcp"
],
"env": {
"AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
"AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
AUDIOBOOKSHELF_URLBase URL of the Audiobookshelf instance, e.g. https://abs.example.comRequiredAUDIOBOOKSHELF_API_KEYAPI key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)RequiredAUDIOBOOKSHELF_READ_ONLYSet to true to register only the 29 read tools and no write toolsAUDIOBOOKSHELF_INSECURE_TLSSet to true to accept self-signed certificates for this connection onlyAUDIOBOOKSHELF_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)AUDIOBOOKSHELF_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS leftAUDIOBOOKSHELF_URLBase URL of the Audiobookshelf instance, e.g. https://abs.example.comRequiredAUDIOBOOKSHELF_API_KEYAPI key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)RequiredAUDIOBOOKSHELF_READ_ONLYSet to true to register only the 29 read tools and no write toolsAUDIOBOOKSHELF_INSECURE_TLSSet to true to accept self-signed certificates for this connection onlyAUDIOBOOKSHELF_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)AUDIOBOOKSHELF_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left
Pricing
Open source
Prices change. Check audiobookshelf-mcp.ni-c.de before you buy.
Audiobookshelf FAQ
Is Audiobookshelf free?
Yes. Audiobookshelf is open source, so you can use and self-host it for free.
How do I add Audiobookshelf to Claude Code?
Run this command in your terminal: claude mcp add audiobookshelf-mcp --env AUDIOBOOKSHELF_URL='<AUDIOBOOKSHELF_URL>' --env AUDIOBOOKSHELF_API_KEY='<AUDIOBOOKSHELF_API_KEY>' -- npx -y audiobookshelf-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.