Bot Essentials
SupportSign in

MCP connector · Audiobooks

Audiobookshelf

Your Audiobookshelf audiobooks and podcasts, by asking.

  • 26 tools
  • 47 tests passing
  • MIT licence
  • Free and open

InstallStar on GitHubSupport the project

See it work

Example. A real tool and its real input. No live data is shown here.

You ask
“List my Audiobookshelf libraries.”
Your bot calls
abs_libraries with action get
It gets back
Libraries from your own Audiobookshelf.

Install

git clone https://github.com/si-essence/audiobookshelf-mcp.git && cd audiobookshelf-mcp && npm install && npm run build

Needs Node.js. Then add the built server to your MCP client. Install guide

Facts

Tools
26
Tests
47 passing
Licence
MIT
Source
github.com/si-essence/audiobookshelf-mcp
Listing updated
31 October 2026
Last code push
29 October 2026
Maintained by
Bot Essentials

Tests were run on 27 October 2026 in a clean copy of each connector. You bring your own keys for any service it talks to.

Details and limits

Audiobookshelf is a local MCP server for a self-hosted Audiobookshelf audiobook and podcast server. The package name is audiobookshelf-mcp. You run it over stdio or stateless Streamable HTTP on localhost. It does not start Audiobookshelf for you. This is free; the catalogue price is Free.

Works with Audiobookshelf. Not affiliated with or endorsed by the Audiobookshelf project.

There is no hosted service in this listing. Bring your own API token from Settings, API Keys. Set ABS_BASE_URL to your server and ABS_API_TOKEN to the token, sent as Authorization: Bearer and never printed.

Writes are confirm-gated. A write is a dry-run preview when confirm is omitted. confirm must be the boolean true, and ABS_ALLOW_WRITES must be the literal true. Deletes, scans, backup restore, user and API key changes carry an extra warning.

The default ABS_TOOLSETS publishes 13 tools (123 operations). Set it to all for 26 tools (181 operations). Each tool takes an action field. Media streams, archive downloads, file uploads and playback session start are left out.

The local limit defaults to 30 requests a minute. A cache hit does not spend that window.

Checked live against a real Audiobookshelf 2.37.2 server: 25 checks passed. Other operations are covered by mock-server tests only.

Audiobookshelf is GPL-3.0. The connector is MIT and only calls the public HTTP API.

Tools

26 tools.

  • abs_libraries

    Libraries: 26 operations (default)

  • abs_items

    Items: 18 operations (default)

  • abs_collections

    Collections: 9 operations (default)

  • abs_playlists

    Playlists: 10 operations (default)

  • abs_me

    Me: 23 operations (default)

  • abs_authors

    Authors: 5 operations (default)

  • abs_series

    Series: 2 operations (default)

  • abs_podcasts

    Podcasts: 12 operations (default)

  • abs_search

    Search: 6 operations (default)

  • abs_sessions

    Sessions: 4 operations (default)

  • abs_stats

    Stats: 2 operations (default)

  • abs_tags

    Tags: 3 operations (default)

  • abs_genres

    Genres: 3 operations (default)

  • abs_admin

    Admin: 8 operations

  • abs_users

    Users: 9 operations

  • abs_backups

    Backups: 5 operations

  • abs_filesystem

    Filesystem: 2 operations

  • abs_notifications

    Notifications: 8 operations

  • abs_emails

    Emails: 5 operations

  • abs_cache

    Cache: 2 operations

  • abs_tools

    Tools: 4 operations

  • abs_feeds

    Feeds: 5 operations

  • abs_metadata_providers

    Metadata providers: 3 operations

  • abs_share

    Share: 2 operations

  • abs_api_keys

    Api keys: 4 operations

  • abs_tasks

    Tasks: 1 operation