Integration

Audiobookshelf integration

Audiobookshelf is a self-hosted server for audiobooks, ebooks and podcasts. The API lets an agent list and manage libraries and their contents, page through library items, series and authors, read and edit an author or a series, upload, download and match an author image, add a podcast from an RSS feed, search a podcast feed for episodes, queue and clear episode downloads, read, edit and delete a podcast episode, parse and create OPML podcast subscriptions, manage notification rules and test them, and configure the outgoing mail settings and e-reader devices used to send an ebook to a device. The host is part of the credential because every install is its own deployment. Authentication is the API token shown in the Audiobookshelf user account settings, sent as a bearer token.

Connect Audiobookshelf How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Audiobookshelf.Built from the 40 Audiobookshelf tools below, on the connection you add once.

What you can do with Audiobookshelf

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Librarie, 5 operations

create_libraryCreate libraryPOSTCreate a new library on server.
delete_libraryDelete libraryDELETEDelete a single library by ID on server.
get_libraryGet libraryGETGet a single library by ID on server.
list_librariesList librariesGETGet all libraries on server.
update_libraryUpdate libraryPATCHUpdate a single library by ID on server.

Notification, 4 operations

create_notificationCreate notificationPOSTCreate notification settings.
delete_notificationDelete notificationDELETEDelete a notification.
list_notificationsList notificationsGETGet notification settings.
update_notificationUpdate notificationPATCHUpdate a notification.

Serie, 4 operations

get_library_seriesGet library seriesGETGet single series in library.
get_seriesGet seriesGETGet series.
list_library_seriesList library seriesGETGet library series.
update_seriesUpdate seriesPATCHUpdate series.

Author, 3 operations

get_authorGet authorGETGet an author by ID.
list_library_authorsList library authorsGETGet all authors in a library.
update_authorUpdate authorPATCHUpdate an author by ID.

Episode, 3 operations

delete_podcast_episodeDelete podcast episodeDELETERemove a podcast episode.
get_podcast_episodeGet podcast episodeGETGet a specific podcast episode.
update_podcast_episodeUpdate podcast episodePATCHUpdate a podcast episode.

Image, 3 operations

delete_author_imageDelete author imageDELETEDelete an author image by author ID.
get_author_imageGet author imageGETGet an author image by author ID.
upload_author_imageUpload author imagePOSTAdd an author image to the server.

Setting, 2 operations

get_email_settingsGet email settingsGETGet email settings.
update_email_settingsUpdate email settingsPATCHUpdate email settings.

Checknew, 1 operation

check_new_episodesCheck new episodesGETCheck and download new episodes.

Clear queue, 1 operation

clear_episode_download_queueClear episode download queueGETClear episode download queue.

Create, 1 operation

create_podcasts_from_opmlCreate podcasts from opmlPOSTBulk create podcasts from OPML feed URLs.

Download, 1 operation

list_episode_downloadsList episode downloadsGETGet episode downloads.

Download episode, 1 operation

download_episodesDownload episodesPOSTDownload podcast episodes.

Ereader device, 1 operation

update_ereader_devicesUpdate ereader devicesPOSTUpdate e-reader devices.

Feed, 1 operation

fetch_podcast_feedFetch podcast feedPOSTGet podcast feed.

Issue, 1 operation

delete_library_items_with_issuesDelete library items with issuesDELETEDelete items with issues in a library.

Item, 1 operation

list_library_itemsList library itemsGETGet items in a library.

Match, 1 operation

match_authorMatch authorPOSTMatch the author against Audible using quick match.

Match episode, 1 operation

match_podcast_episodesMatch podcast episodesPOSTQuick match podcast episodes.

Notificationdata, 1 operation

get_notification_event_dataGet notification event dataGETGet notification event data.

Parse, 1 operation

parse_opml_feedsParse opml feedsPOSTGet feeds from OPML text.

Podcast, 1 operation

create_podcastCreate podcastPOSTCreate a new podcast.

Search episode, 1 operation

search_podcast_episodesSearch podcast episodesGETFind episode by title.

Send ebook to device, 1 operation

send_ebook_to_deviceSend ebook to devicePOSTSend ebook to device.

Use Audiobookshelf from Claude Code, Cursor or Codex

Connect Audiobookshelf in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Audiobookshelf operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Audiobookshelf

Create your workspace
Sign up free. Nothing to install.
Connect Audiobookshelf once
Add your Audiobookshelf connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.