Audiobookshelf MCP
Manage and inspect a self-hosted Audiobookshelf library from your agent with read-only defaults and optional scan or cleanup tools.
Overview
io.github.jeeftor/abs-mcp is a MCP server for the Operate phase that lets agents inspect and safely operate Audiobookshelf libraries over stdio.
What is this MCP server?
- Audiobookshelf MCP with required ABS_BASE_URL and ABS_API_KEY environment variables
- ABS_READ_ONLY defaults to true; set false to enable scan and cleanup tools
- OCI image ghcr.io/jeeftor/abs-mcp:0.2.1 plus configurable ABS_TIMEOUT default 30s
- Optional ABS_FIXTURE_DIR for local fixture resources during development
- Server version 0.2.1 with OCI identifier ghcr.io/jeeftor/abs-mcp:0.2.1
- Five documented environment variables including ABS_READ_ONLY default true
What problem does it solve?
Your Audiobookshelf library is growing on self-hosted infra but agents cannot see titles, libraries, or maintenance actions without a dedicated integration.
Who is it for?
Solo builders who self-host Audiobookshelf and want agent-assisted library management with a read-only default.
Skip if: Users without an Audiobookshelf server or anyone who needs commercial streaming APIs instead of ABS.
What do I get? / Deliverables
After setup, your agent can query and optionally maintain Audiobookshelf with read-only safety unless you explicitly enable scan and cleanup tools.
- Agent-connected Audiobookshelf library inspection
- Configurable read-only or maintenance-capable ABS tool surface
- Documented timeout and fixture options for local testing
Recommended MCP Servers
Journey fit
Audiobookshelf is ongoing personal or homelab infra; MCP access fits maintaining libraries after the server is already deployed. Infra subphase covers self-hosted services, API keys, and safe operational toggles like ABS_READ_ONLY.
How it compares
Self-hosted Audiobookshelf MCP bridge, not a generic podcast CDN or consumer audiobook marketplace skill.
Common Questions / FAQ
Who is abs-mcp for?
Self-hosters running Audiobookshelf who want MCP-driven library inspection and controlled maintenance from coding agents.
When should I use abs-mcp?
Use it in Operate when your ABS instance is live and you want read-only agent access first, then optional scans or cleanup after setting ABS_READ_ONLY to false.
How do I add abs-mcp to my agent?
Run the OCI package ghcr.io/jeeftor/abs-mcp:0.2.1 with stdio MCP, set ABS_BASE_URL and ABS_API_KEY, and register the server in your agent MCP config.