# Reported issues for Audiobookshelf MCP

Pod holds 6 of 6 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [Audiobookshelf MCP](/mcp/audiobookshelf-mcp).

## Most discussed

### Investigate Streamable HTTP transport support

Derived from the AI-generated MCP comparison refresh.

Scope:
- Investigate whether Streamable HTTP is useful for hosted or multi-client abs-mcp deployments.
- Define the authentication and deployment model before implementation.
- Preserve stdio as the default local MCP transport.
- Add docs, tests, and security notes if implemented.

Why this is useful:
- Users who already run Audiobookshelf behind Cloudflare Zero Trust could run abs-mcp near the Audiobookshelf server and expose a remote MCP e

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/5) · 2026-05-20 · closed · 2 comments

### send-ebook-to-device returns malformed response after disabling ABS_READ_ONLY

## Problem

After disabling ABS_READ_ONLY=true and restarting the abs-mcp server, the send_ebook_to_device endpoint returns malformed responses instead of valid JSON, causing the MCP client to mark the server as unreachable after 3 consecutive failures.

## Steps to Reproduce

1. Set ABS_READ_ONLY=false (or --read-only=false)
2. Restart abs-mcp server
3. Attempt to send an ebook to a Kindle device via send_ebook_to_device

## Expected Behavior

The endpoint should return a valid JSON response in

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/8) · 2026-06-24 · closed · 1 comment

### Evaluate Claude Desktop MCPB packaging

Derived from the 2026-06-22 AI-generated MCP comparison refresh.

Scope:
- Evaluate whether Claude Desktop `.mcpb` bundles add meaningful value for `abs-mcp` users alongside the existing release binaries, Docker/GHCR image, and MCP Registry metadata.
- Identify the expected package contents, supported platforms, signing/checksum expectations, and release workflow changes before implementation.
- Preserve existing install paths; `.mcpb` packaging should be additive, not a replacement for binaries

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/7) · 2026-06-22 · open · 1 comment

### Add richer author, series, and collection read tools

Derived from the AI-generated MCP comparison refresh.

Scope:
- Review Audiobookshelf source and fixture behavior for author, series, and collection read endpoints.
- Add read-only MCP tools or resources for useful bounded inspection workflows.
- Prefer pagination and ID-based lookups where result sets can be large.
- Add tests and docs for any accepted surface.

Notes:
- michaeldvinci/audiobookshelf-mcp and sierikov/audiobookshelf-mcp expose broader author/series/collection browsing.
- Keep thi

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/3) · 2026-05-20 · closed · 1 comment

### Add playback progress and bookmark MCP tools

Derived from the AI-generated MCP comparison refresh.

Scope:
- Investigate Audiobookshelf endpoints for playback progress and bookmark workflows.
- Add typed MCP tools only for safe, bounded operations.
- Keep mutating progress/bookmark actions gated behind ABS_READ_ONLY=false.
- Add tests and docs if implemented.

Notes:
- sandymac/audiobookshelf-mcp exposes optional progress/bookmark mutations with mutating tools disabled by default.
- sierikov/audiobookshelf-mcp exposes read-oriented progres

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/2) · 2026-05-20 · closed · 1 comment

### Investigate safely gated backup and server-admin MCP tools

Derived from the AI-generated MCP comparison refresh.

Scope:
- Review Audiobookshelf source and fixture behavior for backup and server-admin endpoints.
- Identify whether any workflow is safe and useful enough for MCP exposure.
- Keep any accepted mutating operation gated behind ABS_READ_ONLY=false.
- Require explicit confirmations for destructive or broad state-changing actions.
- Add tests and docs if implemented.

Notes:
- michaeldvinci/audiobookshelf-mcp exposes a create_backup action.
- Th

[Read the thread](https://github.com/jeeftor/abs-mcp/issues/4) · 2026-05-20 · closed · 0 comments

## Most recent

The remaining reports are on [the project's issue tracker](https://github.com/jeeftor/abs-mcp/issues).