Audiobookshelf MCP Server
A Model Context Protocol server for Audiobookshelf - gives AI assistants access to your self-hosted audiobook and podcast library.
MCP Registry name: mcp-name: io.github.sierikov/audiobookshelf-mcp
What can it do?
Ask your AI assistant things like:
- "What am I currently listening to?"
- "Search for Dune in my library"
- "What are my listening stats?"
- "What did I listen to recently?"
- "How far am I in Katabasis?"
- "What libraries do I have?"
| Tool | Description | Toolset |
|---|
list_libraries | List all libraries | libraries |
search_library | Search by title, author, or narrator | libraries |
list_library_items | List items with pagination | libraries |
get_item | Get detailed info about an audiobook or podcast | items |
get_items_in_progress | Get currently listening items with progress | items |
get_listening_stats | Total listening time and daily breakdown | playback |
get_listening_sessions | Recent listening sessions | playback |
get_media_progress | Progress for a specific item | playback |
list_series | List all series in a library | browse |
get_series | Get series details with books | browse |
get_author | Get author details with books | browse |
list_collections | List collections in a library | browse |
Default toolsets: libraries, items, playback. The browse toolset is opt-in via AUDIOBOOKSHELF_TOOLSETS.
Install in Claude Desktop (one-click)
Download the .mcpb bundle for your platform, open it, and Claude Desktop will walk you through setup.
The .mcpb format is currently only supported by Claude Desktop. Other clients use the manual setup below.
Manual setup (all other clients)
1. Get your API token
Audiobookshelf → Settings → Users → your user → API Token
2. Install the binary
go install:
go install github.com/sierikov/audiobookshelf-mcp/cmd/audiobookshelf-mcp@latest
Download and install to /usr/local/bin:
macOS (Apple Silicon)
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-arm64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
macOS (Intel)
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-amd64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Linux (x64)
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-amd64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Linux (arm64)
curl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-arm64 \
-o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp
Windows
Download audiobookshelf-mcp-windows-amd64.exe, rename to audiobookshelf-mcp.exe, and place it in a directory on your %PATH% (e.g. C:\Program Files\audiobookshelf-mcp\).
Claude Code
claude mcp add audiobookshelf \
-e AUDIOBOOKSHELF_URL=https://abs.example.com \
-e AUDIOBOOKSHELF_TOKEN=your-token \
-- audiobookshelf-mcp
Antigravity CLI (formerly Gemini CLI)
antigravity --add-mcp '{"name":"audiobookshelf","command":"audiobookshelf-mcp","env":{"AUDIOBOOKSHELF_URL":"https://abs.example.com","AUDIOBOOKSHELF_TOKEN":"your-token"}}'
OpenCode
Add to ~/.config/opencode/config.json:
{
"mcpServers": {
"audiobookshelf": {
"type": "stdio",
"command": "audiobookshelf-mcp",
"args": [],
"env": {
"AUDIOBOOKSHELF_URL": "https://abs.example.com",
"AUDIOBOOKSHELF_TOKEN": "your-token"
}
}
}
}
Configuration
| Variable | Required | Default | Description |
|---|
AUDIOBOOKSHELF_URL | Yes | — | Your Audiobookshelf server URL |
AUDIOBOOKSHELF_TOKEN | Yes | — | API token from Settings → Users |
AUDIOBOOKSHELF_TOOLSETS | No | libraries,items,playback | Comma-separated toolsets to enable. Use all to enable everything. |
Security
All tools are read-only - no writes, no playback control, no user management. The API token is passed via environment variable, never logged or exposed.
License
MIT