Skip to main content
Glama
Audiobookshelf MCP Server

Audiobookshelf MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ABS_URLYesBase URL of Audiobookshelf, e.g. http://192.168.1.10:13378 or https://example.com/audiobookshelf (reverse-proxy sub-paths are supported).
ABS_TOKENNoAlias for ABS_API_KEY.
LOG_LEVELNoerror, warn, info or debug. Logs go to stderr with secrets redacted. Default info.info
ABS_API_KEYNoAPI key (or legacy user token). Either ABS_API_KEY, ABS_TOKEN or ABS_API_KEY_FILE is required.
MCP_HTTP_HOSTNoBind address for HTTP mode. Default 127.0.0.1 (the Docker image uses 0.0.0.0).127.0.0.1
MCP_HTTP_PATHNoEndpoint path for HTTP mode. Default /mcp./mcp
MCP_HTTP_PORTNoPort for HTTP mode. Default 3000.3000
MCP_TRANSPORTNostdio or http. Default stdio.stdio
ABS_LIBRARY_IDSNoComma-separated library IDs or names this server may use. Everything else is invisible to the assistant.
ABS_MAX_RESULTSNoUpper limit on the number of results any single call can request. Default 50.50
ABS_API_KEY_FILENoPath to a file containing the key, e.g. a Docker secret. Used if ABS_API_KEY is unset.
ABS_DEFAULT_LIBRARYNoLibrary ID or name used when a tool call doesn't specify one. Defaults to the first audiobook library.
MCP_HTTP_AUTH_TOKENNoBearer token clients must send. Required when the host isn't loopback.
ABS_CACHE_TTL_SECONDSNoHow long libraries, progress and stats are cached in memory. 0 disables caching. Default 60.60
ABS_ENABLE_WRITE_TOOLSNoSet to true to register the write tools. Default false.false
ABS_REQUEST_TIMEOUT_MSNoPer-request timeout to Audiobookshelf in milliseconds. Default 30000.30000
ABS_STALLED_AFTER_DAYSNoA book you've started but not touched for this many days counts as stalled. Default 60.60
MCP_HTTP_ALLOWED_HOSTSNoComma-separated Host header values to accept (turns on DNS-rebinding protection).
ABS_DESCRIPTION_MAX_CHARSNoBook descriptions are truncated to this length; 0 omits them. Default 300.300

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for an Audiobookshelf (self-hosted audiobook server) library. Everything is scoped to the user who owns the configured API key: progress, history and playlists are theirs. For recommendations: call abs_get_taste_profile first, then propose candidates and filter them with abs_check_owned. IDs (items, authors, series) come from search/list results; name arguments are also accepted where noted. "stalled" means started but not touched for a while; it is a weak dislike signal, not a firm one. Audiobookshelf only knows about books in the library: it cannot tell you about unowned books in a series.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
abs_get_server_infoA

Check the connection and see who the API key belongs to, the server version, the libraries this server may use, and whether write tools are enabled. Call this first if other tools fail.

abs_list_librariesA

List the Audiobookshelf libraries this server can use, with item counts.

abs_search_libraryA

Full-text search of one library: matches book titles/subtitles, authors, series, narrators, genres and tags. Best for "do I have X?" or finding an ID. For checking many candidate titles at once use abs_check_owned.

abs_list_library_itemsA

Browse a library with ONE optional filter (author, series, genre, tag, narrator, language, publisher or your progress) plus sorting and paging. Names are matched case-insensitively. Use for "show me all X" questions.

abs_get_itemB

Full details for one library item: authors, narrators, series with sequence, genres, tags, description, length, and your progress. Optionally the chapter list.

abs_list_authorsC

List authors in a library with how many books of theirs it holds.

abs_get_authorB

An author's books in the library, grouped by series, each with your progress. Accepts a name or ID.

abs_list_seriesB

List series in a library with the number of books held for each.

abs_get_seriesA

Books of one series that are in the library, in reading order, with your status for each, the next unfinished one, and whole-number gaps in the owned sequence (e.g. own 1, 2, 4 → missing 3). Books never added to the library are not known to Audiobookshelf.

abs_get_library_facetsB

The distinct genres, tags, narrators, languages and publishers present in a library — useful for exact filter values and for describing the collection.

abs_get_listening_progressA

Books the API key user has started or finished, newest activity first. "stalled" = started but untouched for longer than ABS_STALLED_AFTER_DAYS.

abs_get_listening_statsA

Listening time totals (all time, last 7/30/365 days), by weekday, most-listened items, and recent sessions. Pass year for that year’s Audiobookshelf "year in review" stats.

abs_get_listening_sessionsB

Individual listening sessions (newest first): what was played, when, for how long, on which device.

abs_get_taste_profileA

One-call summary of the user’s listening taste for making recommendations: top authors, series, genres, narrators and tags weighted by engagement; length and era preferences; recently finished, current and stalled books; per-series status (next owned unfinished book, gaps); and unread books already owned by favourite authors. Use before recommending, then verify candidates with abs_check_owned.

abs_check_ownedA

Given candidate books (title + optional author), report which are already in the library and whether the user has listened to them. Tolerates subtitles, leading articles, punctuation and "(Unabridged)". confidence: exact | likely | possible. Use to filter recommendations before requesting downloads.

abs_list_collectionsC

Collections in a library (shared, curated lists) with their books.

abs_list_playlistsB

The API key user's playlists (personal, ordered lists) across allowed libraries.

Prompts

Interactive templates invoked by user choice

NameDescription
recommend_audiobooksRecommend books I do not own yet, based on my Audiobookshelf listening history.
continue_my_seriesFind series I have started and what to listen to (or get) next in each.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 17 tools

Disambiguation4/5

Most tools have clearly distinct purposes (browse vs. search vs. detail vs. owned-check), and descriptions explicitly steer between near-neighbours like abs_search_library vs abs_check_owned and abs_list_authors vs abs_get_author. The only mild overlap is the trio abs_get_listening_progress / abs_get_listening_stats / abs_get_listening_sessions, which all describe recent listening but at different granularities.

Naming Consistency5/5

All 17 tools use a uniform abs_ prefix plus snake_case verb_noun naming (abs_list_*, abs_get_*, abs_search_*, abs_check_*), with no camelCase or style mixing. Verb choices map predictably to actions, so naming gives strong cues about each tool's role.

Tool Count4/5

17 tools is just over the comfortable 3-15 band but each one covers a distinct slice of the Audiobookshelf domain (libraries, items, authors, series, collections, playlists, stats, recommendations). There is no obviously redundant or filler tool, so the count is justified rather than bloated.

Completeness4/5

The read/exploration surface is thorough: connection info, library browsing, search, facets, item/author/series details, collections, playlists, listening stats, taste profile and owned-check all exist. The notable gap is write operations — despite abs_get_server_info mentioning "write tools are enabled", the surfaced set contains no create/update/delete for playlists, collections or progress.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues