Provides tools to interact with an Audiobookshelf server, enabling AI assistants to query library, items, listening progress, stats, series, authors, and collections.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Audiobookshelf MCP Server What am I currently listening to?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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?"
Related MCP server: mcp-open-library
Tool | Description | Toolset |
| List all libraries | libraries |
| Search by title, author, or narrator | libraries |
| List items with pagination | libraries |
| Get detailed info about an audiobook or podcast | items |
| Get currently listening items with progress | items |
| Total listening time and daily breakdown | playback |
| Recent listening sessions | playback |
| Progress for a specific item | playback |
| List all series in a library | browse |
| Get series details with books | browse |
| Get author details with books | browse |
| List collections in a library | browse |
Default toolsets: libraries, items, playback. The browse toolset is opt-in via AUDIOBOOKSHELF_TOOLSETS.
Download the .mcpb bundle for your platform, open it, and Claude Desktop will walk you through setup.
Platform | Download |
macOS (Apple Silicon) | |
macOS (Intel) | |
Windows | |
Linux x64 | |
Linux arm64 |
The
.mcpbformat is currently only supported by Claude Desktop. Other clients use the manual setup below.
Audiobookshelf → Settings → Users → your user → API Token
go install:
go install github.com/sierikov/audiobookshelf-mcp/cmd/audiobookshelf-mcp@latestDownload 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-mcpcurl -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-mcpcurl -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-mcpcurl -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-mcpDownload 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 mcp add audiobookshelf \
-e AUDIOBOOKSHELF_URL=https://abs.example.com \
-e AUDIOBOOKSHELF_TOKEN=your-token \
-- audiobookshelf-mcpantigravity --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"
}
}
}
}Variable | Required | Default | Description |
| Yes | — | Your Audiobookshelf server URL |
| Yes | — | API token from Settings → Users |
| No |
| Comma-separated toolsets to enable. Use |
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.
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
