{
  "markdown": "# Audiobookshelf MCP Server\n\n[![Go](https://github.com/sierikov/audiobookshelf-mcp/actions/workflows/go.yml/badge.svg)](https://github.com/sierikov/audiobookshelf-mcp/actions/workflows/go.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/sierikov/audiobookshelf-mcp)](https://goreportcard.com/report/github.com/sierikov/audiobookshelf-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-published-light)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sierikov/audiobookshelf-mcp)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for [Audiobookshelf](https://www.audiobookshelf.org/) - gives AI assistants access to your self-hosted audiobook and podcast library.\n\nMCP Registry name: `mcp-name: io.github.sierikov/audiobookshelf-mcp`\n\n## What can it do?\n\nAsk your AI assistant things like:\n\n- \"What am I currently listening to?\"\n- \"Search for Dune in my library\"\n- \"What are my listening stats?\"\n- \"What did I listen to recently?\"\n- \"How far am I in Katabasis?\"\n- \"What libraries do I have?\"\n\n## Tools\n\n| Tool | Description | Toolset |\n|---|---|---|\n| `list_libraries` | List all libraries | libraries |\n| `search_library` | Search by title, author, or narrator | libraries |\n| `list_library_items` | List items with pagination | libraries |\n| `get_item` | Get detailed info about an audiobook or podcast | items |\n| `get_items_in_progress` | Get currently listening items with progress | items |\n| `get_listening_stats` | Total listening time and daily breakdown | playback |\n| `get_listening_sessions` | Recent listening sessions | playback |\n| `get_media_progress` | Progress for a specific item | playback |\n| `list_series` | List all series in a library | browse |\n| `get_series` | Get series details with books | browse |\n| `get_author` | Get author details with books | browse |\n| `list_collections` | List collections in a library | browse |\n\nDefault toolsets: `libraries`, `items`, `playback`. The `browse` toolset is opt-in via `AUDIOBOOKSHELF_TOOLSETS`.\n\n---\n\n## Install in Claude Desktop (one-click)\n\nDownload the `.mcpb` bundle for your platform, open it, and Claude Desktop will walk you through setup.\n\n| Platform | Download |\n|---|---|\n| macOS (Apple Silicon) | [audiobookshelf-mcp-macos-arm64.mcpb](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-arm64.mcpb) |\n| macOS (Intel) | [audiobookshelf-mcp-macos-amd64.mcpb](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-amd64.mcpb) |\n| Windows | [audiobookshelf-mcp-windows-amd64.mcpb](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-windows-amd64.mcpb) |\n| Linux x64 | [audiobookshelf-mcp-linux-amd64.mcpb](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-amd64.mcpb) |\n| Linux arm64 | [audiobookshelf-mcp-linux-arm64.mcpb](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-arm64.mcpb) |\n\n> The `.mcpb` format is currently only supported by Claude Desktop. Other clients use the manual setup below.\n\n---\n\n## Manual setup (all other clients)\n\n### 1. Get your API token\n\nAudiobookshelf → Settings → Users → your user → **API Token**\n\n### 2. Install the binary\n\n**go install:**\n```bash\ngo install github.com/sierikov/audiobookshelf-mcp/cmd/audiobookshelf-mcp@latest\n```\n\n**Download and install to `/usr/local/bin`:**\n\n<details>\n<summary>macOS (Apple Silicon)</summary>\n\n```bash\ncurl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-arm64 \\\n  -o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp\n```\n\n</details>\n\n<details>\n<summary>macOS (Intel)</summary>\n\n```bash\ncurl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-macos-amd64 \\\n  -o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp\n```\n\n</details>\n\n<details>\n<summary>Linux (x64)</summary>\n\n```bash\ncurl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-amd64 \\\n  -o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp\n```\n\n</details>\n\n<details>\n<summary>Linux (arm64)</summary>\n\n```bash\ncurl -L https://github.com/sierikov/audiobookshelf-mcp/releases/latest/download/audiobookshelf-mcp-linux-arm64 \\\n  -o /usr/local/bin/audiobookshelf-mcp && chmod +x /usr/local/bin/audiobookshelf-mcp\n```\n\n</details>\n\n<details>\n<summary>Windows</summary>\n\nDownload [`audiobookshelf-mcp-windows-amd64.exe`](https://github.com/sierikov/audiobookshelf-mcp/releases/latest/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\\`).\n\n</details>\n\n### 3. Configure your client\n\n<details>\n<summary>Claude Code</summary>\n\n```bash\nclaude mcp add audiobookshelf \\\n  -e AUDIOBOOKSHELF_URL=https://abs.example.com \\\n  -e AUDIOBOOKSHELF_TOKEN=your-token \\\n  -- audiobookshelf-mcp\n```\n\n</details>\n\n<details>\n<summary>Antigravity CLI (formerly Gemini CLI)</summary>\n\n```bash\nantigravity --add-mcp '{\"name\":\"audiobookshelf\",\"command\":\"audiobookshelf-mcp\",\"env\":{\"AUDIOBOOKSHELF_URL\":\"https://abs.example.com\",\"AUDIOBOOKSHELF_TOKEN\":\"your-token\"}}'\n```\n\n</details>\n\n<details>\n<summary>OpenCode</summary>\n\nAdd to `~/.config/opencode/config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"audiobookshelf\": {\n      \"type\": \"stdio\",\n      \"command\": \"audiobookshelf-mcp\",\n      \"args\": [],\n      \"env\": {\n        \"AUDIOBOOKSHELF_URL\": \"https://abs.example.com\",\n        \"AUDIOBOOKSHELF_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `AUDIOBOOKSHELF_URL` | Yes | — | Your Audiobookshelf server URL |\n| `AUDIOBOOKSHELF_TOKEN` | Yes | — | API token from Settings → Users |\n| `AUDIOBOOKSHELF_TOOLSETS` | No | `libraries,items,playback` | Comma-separated toolsets to enable. Use `all` to enable everything. |\n\n---\n\n## Security\n\nAll tools are **read-only** - no writes, no playback control, no user management. The API token is passed via environment variable, never logged or exposed.\n\n## License\n\nMIT\n",
  "bytes": 6330,
  "sha": "2e456b90264f8fb67de4b81356a679b7503d11f03cc9d62d492009c67e037afd",
  "repo_slug": "sierikov/audiobookshelf-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sierikov_audiobookshelf_mcp_c5d06e4d/readme"
}