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?"
Tools
| 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.
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | audiobookshelf-mcp-macos-arm64.mcpb |
| macOS (Intel) | audiobookshelf-mcp-macos-amd64.mcpb |
| Windows | audiobookshelf-mcp-windows-amd64.mcpb |
| Linux x64 | audiobookshelf-mcp-linux-amd64.mcpb |
| Linux arm64 | audiobookshelf-mcp-linux-arm64.mcpb |
The
.mcpbformat 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:
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
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
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
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
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\).
3. Configure your client
<details> <summary>Claude Code</summary>claude mcp add audiobookshelf \
-e AUDIOBOOKSHELF_URL=https://abs.example.com \
-e AUDIOBOOKSHELF_TOKEN=your-token \
-- audiobookshelf-mcp
antigravity --add-mcp '{"name":"audiobookshelf","command":"audiobookshelf-mcp","env":{"AUDIOBOOKSHELF_URL":"https://abs.example.com","AUDIOBOOKSHELF_TOKEN":"your-token"}}'
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