Audiobookshelf MCP
Connects to Audiobookshelf instances to inspect libraries, search items, and audit whether your audiobooks are organized the way you expect on disk. Runs read-only by default. Flip ABS_READ_ONLY to false and you can trigger scans, remove covers, update chapters, and run cleanup workflows. The abs_find_misorganized_items tool checks paths against author/title and author/series/title conventions without touching files, making it a good companion to Audiobook Organizer for spotting layout problems before you reorganize. Written in Go, ships as a single binary or Docker image, and includes fixture tests backed by the real Audiobookshelf API surface.
- GitHub stars
- 1
- tools
- 51
- auth
- Secret needed
- transport
- STDIO
- env vars
- 12
- last updated
- Jul 29, 2026
Tools
51 toolsPublic tool metadata for what this MCP can expose to an agent.
abs_health_check
No parameter schema in public metadata yet.
abs_list_libraries
No parameter schema in public metadata yet.
abs_get_library
No parameter schema in public metadata yet.
abs_list_library_items
No parameter schema in public metadata yet.
abs_get_library_item
No parameter schema in public metadata yet.
abs_search_library
No parameter schema in public metadata yet.
abs_search_ebooks
No parameter schema in public metadata yet.
abs_preview_ebook_device_sendRead-only preview for device-send UX returning compact ebook candidates, sanitized device names, ready status, and the exact confirmation string when one ebook and one saved device name resolve.
Read-only preview for device-send UX returning compact ebook candidates, sanitized device names, ready status, and the exact confirmation string when one ebook and one saved device name resolve.
No parameter schema in public metadata yet.
abs_get_library_stats
No parameter schema in public metadata yet.
abs_get_filter_data
No parameter schema in public metadata yet.
abs_list_library_authors
No parameter schema in public metadata yet.
abs_get_author
No parameter schema in public metadata yet.
abs_list_library_series
No parameter schema in public metadata yet.
abs_get_series
No parameter schema in public metadata yet.
abs_list_collections
No parameter schema in public metadata yet.
abs_get_collection
No parameter schema in public metadata yet.
abs_get_items_in_progress
No parameter schema in public metadata yet.
abs_get_listening_stats
No parameter schema in public metadata yet.
abs_list_listening_sessions
No parameter schema in public metadata yet.
abs_get_item_progress
No parameter schema in public metadata yet.
abs_list_bookmarks
No parameter schema in public metadata yet.
abs_list_backups
No parameter schema in public metadata yet.
abs_list_ereader_devices
No parameter schema in public metadata yet.
abs_send_ebook_to_device
No parameter schema in public metadata yet.
abs_send_ebook_by_query
No parameter schema in public metadata yet.
abs_get_item_metadata_object
No parameter schema in public metadata yet.
abs_find_misorganized_items
No parameter schema in public metadata yet.
abs_scan_library
No parameter schema in public metadata yet.
abs_scan_library_and_wait
No parameter schema in public metadata yet.
abs_scan_item
No parameter schema in public metadata yet.
abs_update_item_metadata
No parameter schema in public metadata yet.
abs_update_item_progress
No parameter schema in public metadata yet.
abs_create_bookmark
No parameter schema in public metadata yet.
abs_update_bookmark
No parameter schema in public metadata yet.
abs_create_backup
No parameter schema in public metadata yet.
abs_update_item_cover
No parameter schema in public metadata yet.
abs_remove_item_cover
No parameter schema in public metadata yet.
abs_update_item_chapters
No parameter schema in public metadata yet.
abs_create_collection
No parameter schema in public metadata yet.
abs_update_collection
No parameter schema in public metadata yet.
abs_delete_collection
No parameter schema in public metadata yet.
abs_add_collection_item
No parameter schema in public metadata yet.
abs_remove_collection_item
No parameter schema in public metadata yet.
abs_create_playlist
No parameter schema in public metadata yet.
abs_update_playlist
No parameter schema in public metadata yet.
abs_delete_playlist
No parameter schema in public metadata yet.
abs_add_playlist_item
No parameter schema in public metadata yet.
abs_remove_playlist_item
No parameter schema in public metadata yet.
abs_remove_library_items_with_issues
No parameter schema in public metadata yet.
abs_match_item
No parameter schema in public metadata yet.
abs_update_item_tracks
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
ABS_BASE_URL*Base URL of your Audiobookshelf server.
ABS_API_KEY*secretAudiobookshelf API key or bearer token.
ABS_READ_ONLYdefault: trueSet to false to enable scan and cleanup tools.
ABS_TIMEOUTdefault: 30sAudiobookshelf request timeout as a Go duration or seconds.
ABS_FIXTURE_DIRdefault: test/absOptional local ABS fixture directory for fixture resources.
ABS_EXTRA_HEADERS_FILEOptional JSON file containing extra request headers.
ABS_TLS_CA_CERT_FILEOptional PEM CA bundle for private or corporate ABS TLS.
ABS_TLS_INSECURE_SKIP_VERIFYdefault: falseTemporary TLS verification bypass for local troubleshooting.
ABS_TRANSPORTdefault: stdioMCP transport to run at startup. Use stdio for local launchers or http for Streamable HTTP.
ABS_HTTP_ADDRdefault: 127.0.0.1:3333Bind address used when ABS_TRANSPORT=http.
ABS_HTTP_PATHdefault: /mcpStreamable HTTP endpoint path used when ABS_TRANSPORT=http.
ABS_HTTP_BEARER_TOKENsecretOptional bearer token required from Streamable HTTP MCP clients.
Readme
Audiobookshelf MCP logo
Audiobookshelf MCP Server
A Go MCP server for inspecting and safely operating Audiobookshelf libraries.
abs-mcp exposes safe, typed MCP tools and resources for agents that need to
inspect Audiobookshelf libraries, diagnose scans, and optionally trigger bounded
maintenance workflows.
Table of Contents
- Highlights
- Audiobook Organizer Compatibility
- AI Generated Comparison - Last updated 2026-06-22
- Quick Start
- MCP Surface
- Configuration
- Safety
- Installation
- Local Development
- Tests
- CI and Releases
- MCP Registry
Highlights
Details
- Repository
- github.com/jeeftor/abs-mcp
- Package
ghcr.io/jeeftor/abs-mcp:0.6.0- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active