Audiobookshelf MCP server

Read from the package source without running it. The installed server may list more.

• add_books_to_collection

  Adds one or more books to an existing collection. Books already in the

• add_items_to_playlist

  Appends books or podcast episodes to a playlist. All entries must come

• create_bookmarkwrite action

  Creates a bookmark at a position of a book for the API key’s user. The

• create_collectionwrite action

  Creates a collection of books. Audiobookshelf rejects empty

• create_playlistwrite action

  Creates a playlist for the API key’s user. Unlike a collection it may

• delete_bookmarkwrite action

  Deletes the bookmark at a given position. Asks a person first; where

• delete_collectionwrite action

  Deletes a collection. The books stay in the library, but the curated

• delete_media_progresswrite action

  Deletes a progress record of the API key’s user, which removes the

• delete_playlistwrite action

  Deletes a playlist. The media stays in the library.

• get_author

  Fetches a single author, optionally with the library items attributed

• get_collection

  Fetches one collection with the books it contains, in order.

• get_item_chapters

  Returns the chapter list of a book with start and end times in seconds.

• get_library

  Fetches a single library including its folders and scanner settings.

• get_library_filter_data

  Returns the values that can be filtered on in this library: authors,

• get_library_item

  Fetches one book or podcast including its metadata, tags and the

• get_library_stats

  Statistics for one library: number of items, authors and genres, total

• get_listening_stats

  Aggregated listening statistics of the current user: total time, time

• get_me

  Returns the Audiobookshelf user the API key acts on behalf of, with

• get_media_progress

  The listening progress of the current user for one book or podcast

• get_personalized_shelves

  The shelves of the Audiobookshelf home screen for this user: Continue

• get_playlist

  Fetches one playlist with its entries, in order.

• get_podcast_episode

  Fetches one podcast episode with its publication date, duration and

• get_series

  Fetches a single series by id, including its books. To list the books

• get_server_status

  Version and initialization state of the Audiobookshelf server. Useful

• get_year_stats

  The "year in review" statistics of the current user for one calendar

• list_authors

  Lists all authors of a book library with their number of books. To list

• list_bookmarks

  The bookmarks of the current user — either all of them, or those of one

• list_collections

  Lists collections — the curated, ordered groups of books. Without

• list_genres

  Lists all genres used on the server, across libraries. Genres come from

• list_items_in_progress

  The items the user has started but not finished, newest first — the

• list_libraries

  Lists the Audiobookshelf libraries the API key’s user can access, with

• list_library_items

  Lists items (books or podcasts) of a library, paginated, sortable and

• list_listening_sessions

  The playback sessions of the current user, newest first — each entry is

• list_playlists

  Lists the playlists of the API key’s user. Without library_id it returns

• list_recent_episodes

  Lists the most recently published episodes across a podcast library —

• list_series

  Lists the series of a book library with their number of books and total

• list_tags

  Lists all tags used on the server, across libraries. Tags are the

• remove_books_from_collectionwrite action

  Removes books from a collection. The books themselves are untouched —

• remove_items_from_playlistwrite action

  Removes entries from a playlist. The media itself is untouched and the

• search_library

  Full-text search within one library. Matches books, podcasts, series,

• set_media_progresswrite action

  Creates or updates the listening progress of the API key’s user for one

• update_bookmarkwrite action

  Renames the bookmark at a given position. The position itself cannot be

• update_collectionwrite action

  Renames a collection, changes its description or reorders its books.

• update_playlistwrite action

  Renames a playlist, changes its description or reorders its entries.

• Code scan37 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 4 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Audiobookshelf: common questions

Is Audiobookshelf MCP server safe?

Mostly: it is graded B (83/100). Read the Audiobookshelf safety report

How do I install Audiobookshelf?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Audiobookshelf need an API key?

Yes. The registry entry asks for AUDIOBOOKSHELF_API_KEY.

Is Audiobookshelf maintained?

The last commit was 4 days ago (2026-09-16). The latest release is v0.4.0.