Audiobookshelf
Browse libraries, search books, and control playback in your self-hosted Audiobookshelf instance.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
https://github.com/sierikov/audiobookshelf-mcp/releases/download/v0.0.1/audiobookshelf-mcp-macos-arm64.mcpbhttps://github.com/sierikov/audiobookshelf-mcp/releases/download/v0.0.1/audiobookshelf-mcp-macos-amd64.mcpbhttps://github.com/sierikov/audiobookshelf-mcp/releases/download/v0.0.1/audiobookshelf-mcp-linux-amd64.mcpbhttps://github.com/sierikov/audiobookshelf-mcp/releases/download/v0.0.1/audiobookshelf-mcp-linux-arm64.mcpbhttps://github.com/sierikov/audiobookshelf-mcp/releases/download/v0.0.1/audiobookshelf-mcp-windows-amd64.mcpbDocumentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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@latestDownload 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-mcpmacOS (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-mcpLinux (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-mcpLinux (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-mcpWindows
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
Claude Code
claude mcp add audiobookshelf \
-e AUDIOBOOKSHELF_URL=https://abs.example.com \
-e AUDIOBOOKSHELF_TOKEN=your-token \
-- audiobookshelf-mcpAntigravity 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
Frequently asked questions
What is Audiobookshelf?
Browse libraries, search books, and control playback in your self-hosted Audiobookshelf instance.
How do I install Audiobookshelf?
Follow the installation steps in its documentation, shown on this page and in its repository.
Does Audiobookshelf need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Audiobookshelf open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Audiobookshelf?
It is published by sierikov. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.