Audiobookshelf

Provides tools to interact with Audiobookshelf via MCP to manage libraries, items, authors, collections, playlists, and user data.

go

1

GitHub Stars

go

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "michaeldvinci-audiobookshelf-mcp": {
      "command": "/path/to/abs-mcp",
      "args": [],
      "env": {
        "ABS_API_KEY": "YOUR_API_TOKEN",
        "ABS_BASE_URL": "https://abs.example.com"
      }
    }
  }
}

You can run an MCP server that exposes Audiobookshelf data to AI assistants, letting you manage libraries, items, authors, collections, playlists, and user information through conversations. This server acts as a bridge between Audiobookshelf and your preferred MCP clients, enabling natural language queries and automated interactions.

How to use

Connect an MCP client to your server using the provided stdio configuration. The server exposes tools to list libraries, fetch items, browse authors, manage collections and playlists, and access user data. You can run commands locally and interact with Audiobookshelf through your assistant just as you would with a standard API, but with conversational prompts.

How to install

Prerequisites you need before installation: a Audiobookshelf instance with API access and an API token, and Go 1.21 or later if you plan to build from source.

Option 1: Install from a pre-built release (the easiest way)

Option 2: Build from source if you prefer to compile locally

Configuration and usage notes

Set up environment variables to point the MCP server at your Audiobookshelf instance and provide authentication.

Available tools

libraries

List all libraries or fetch specific library resources such as items, authors, series, collections, playlists, personalized views, filter data, and statistics.

library

Get a single library by ID or fetch sub-resources like items, authors, series, collections, and playlists with optional flags.

create_library

Create a new library by providing name, folders, and media type, with optional icon or provider.

item

Get a single item by ID or fetch sub-resources like cover image and tone object.

author

Get a single author by ID.

collections

List all collections or retrieve a single collection by ID; supports creating collections and adding items.

playlists

List all playlists or a specific playlist; supports creating playlists and adding items.

user

Get authenticated user information and related sub-resources like listening sessions and progress.

sessions

List playback sessions or retrieve a single session by ID.

podcasts

List podcasts and access feed or OPML exports; fetch podcast episodes and downloads.

check_podcast_episodes

Check for new episodes for a podcast.

update_progress

Update listening progress for a media item, with optional duration and episode association.

create_backup

Create a server backup.