audiobookshelf-mcp

MCPattested
v0.4.0io.github.ni-cMITUpdated 28d agonpmGitHub

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

Works in
ClaudeCursorCopilotGemini

Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.

Attested build
A verified provenance attestation binds this artifact to the listed repository. Nobody has claimed the listing yet — this proves where the code was built, not who stands behind it.
28d agoLast update
Needs 1 credential before it runs
  • AUDIOBOOKSHELF_API_KEYAPI keyrequired

    API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)

Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Package
Authorio.github.ni-c
LicenseMIT
Version0.4.0
Sourcenpm+mcp-registry
Trust Status
A
85/100Trusted
✓Listed in Forge index+10/10
✓Identity verified · attested build+20/20
—Ed25519 publish signature+0/5
→ Included automatically when the publisher runs `forge publish`
—Domain verification+0/5
→ Publisher: host /.well-known/forge.json on the package homepage with { "publisher": "<github-login>" }
✓npm Trusted Publishing (Sigstore)+5/5
—npm maintainer match+0/5
→ Publisher: add the verified GitHub login to the npm package's maintainers (npm owner add <login>)
✓CVE scan · clean+30/30
✓Static analysis · clean+20/20
Paste into Claude Code, Cursor, or any AI assistant to fix all gaps
StatusIdentity verified
PublisherUnverified
SignatureUnsigned
Domain—
Provenance✓ Sigstore-verified · 66badce
Dependencies✓ 60 resolved+ · none vulnerable
Tool surface40 tools · 4 privileged
Security scan✓ Cleanv0.2.0 · 1mo agoHow well does this scan work?
EvalsNone
IndexedAug 18, 2026

Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.

Tools

40 tools · 4 privileged
Statically extracted from the published packagev0.2.0 · 1mo ago

Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

create_collectionCreates a collection of books. Audiobookshelf rejects empty

Creates a collection of books. Audiobookshelf rejects empty

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_podcast_episodeFetches one podcast episode with its publication date, duration and

Fetches one podcast episode with its publication date, duration and

No input schema was published for this tool.

list_recent_episodesLists the most recently published episodes across a podcast library —

Lists the most recently published episodes across a podcast library —

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_libraryFetches a single library including its folders and scanner settings.

Fetches a single library including its folders and scanner settings.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_authorFetches a single author, optionally with the library items attributed

Fetches a single author, optionally with the library items attributed

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_server_statusVersion and initialization state of the Audiobookshelf server. Useful

Version and initialization state of the Audiobookshelf server. Useful

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_playlistFetches one playlist with its entries, in order.

Fetches one playlist with its entries, in order.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

delete_playlistprivilegedDeletes a playlist. The media stays in the library. Two-step: the first

Deletes a playlist. The media stays in the library. Two-step: the first

No input schema was published for this tool.

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

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

No input schema was published for this tool.

40 of 40 tools published a description.

Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.

About

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

Keywords
mcp
Alternatives
Comparing tool surfaces…

Dependency tree

What one Forge scan resolved from npm metadata on 2026-09-01 — observed resolution, not a publisher declaration.

60 packages resolved · 3 direct · none carrying advisories Resolution stops at depth 4 and 60 packages.

The crawl stopped at the depth-4 limit. Anything below that level was never resolved.

The crawl stopped at the 60-package limit. The rest of the tree was never resolved.

36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)

Declared but not resolved

54 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.

+42 more not listed. The counts by reason above cover all of them.

Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.