Audiobookshelf

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

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

3. Configure your client

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

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