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 .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:

bash

go install github.com/sierikov/audiobookshelf-mcp/cmd/audiobookshelf-mcp@latest

Download and install to /usr/local/bin:

macOS (Apple Silicon)

Terminal

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)

Terminal

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)

Terminal

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)

Terminal

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\).

3. Configure your client

Claude Code

Terminal

claude mcp add audiobookshelf \
  -e AUDIOBOOKSHELF_URL=https://abs.example.com \
  -e AUDIOBOOKSHELF_TOKEN=your-token \
  -- audiobookshelf-mcp

Antigravity CLI (formerly Gemini CLI)

bash

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:

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