Audiobookshelf MCP

Name: Audiobookshelf MCP
Author: jeeftor

by jeeftorversion 0.6.0i★ –iRuns on your computer

Registry nameio.github.jeeftor/abs-mcp

Install

Overview

Description from the maker (original English)

Inspect and safely operate Audiobookshelf libraries over MCP.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: ABS_BASE_URL, ABS_API_KEY, ABS_READ_ONLY, ABS_TIMEOUT, ABS_FIXTURE_DIR, ABS_EXTRA_HEADERS_FILE, ABS_TLS_CA_CERT_FILE, ABS_TLS_INSECURE_SKIP_VERIFY, ABS_TRANSPORT, ABS_HTTP_ADDR, ABS_HTTP_PATH, ABS_HTTP_BEARER_TOKEN

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

DockerDocker installed

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "abs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_READ_ONLY",
        "-e",
        "ABS_TIMEOUT",
        "-e",
        "ABS_FIXTURE_DIR",
        "-e",
        "ABS_EXTRA_HEADERS_FILE",
        "-e",
        "ABS_TLS_CA_CERT_FILE",
        "-e",
        "ABS_TLS_INSECURE_SKIP_VERIFY",
        "-e",
        "ABS_TRANSPORT",
        "-e",
        "ABS_HTTP_ADDR",
        "-e",
        "ABS_HTTP_PATH",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "your-value",
        "ABS_API_KEY": "your-value",
        "ABS_READ_ONLY": "your-value",
        "ABS_TIMEOUT": "your-value",
        "ABS_FIXTURE_DIR": "your-value",
        "ABS_EXTRA_HEADERS_FILE": "your-value",
        "ABS_TLS_CA_CERT_FILE": "your-value",
        "ABS_TLS_INSECURE_SKIP_VERIFY": "your-value",
        "ABS_TRANSPORT": "your-value",
        "ABS_HTTP_ADDR": "your-value",
        "ABS_HTTP_PATH": "your-value",
        "ABS_HTTP_BEARER_TOKEN": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add abs --env ABS_BASE_URL=your-value --env ABS_API_KEY=your-value --env ABS_READ_ONLY=your-value --env ABS_TIMEOUT=your-value --env ABS_FIXTURE_DIR=your-value --env ABS_EXTRA_HEADERS_FILE=your-value --env ABS_TLS_CA_CERT_FILE=your-value --env ABS_TLS_INSECURE_SKIP_VERIFY=your-value --env ABS_TRANSPORT=your-value --env ABS_HTTP_ADDR=your-value --env ABS_HTTP_PATH=your-value --env ABS_HTTP_BEARER_TOKEN=your-value -- docker run -i --rm -e ABS_BASE_URL -e ABS_API_KEY -e ABS_READ_ONLY -e ABS_TIMEOUT -e ABS_FIXTURE_DIR -e ABS_EXTRA_HEADERS_FILE -e ABS_TLS_CA_CERT_FILE -e ABS_TLS_INSECURE_SKIP_VERIFY -e ABS_TRANSPORT -e ABS_HTTP_ADDR -e ABS_HTTP_PATH -e ABS_HTTP_BEARER_TOKEN ghcr.io/jeeftor/abs-mcp:0.6.0

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "abs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_READ_ONLY",
        "-e",
        "ABS_TIMEOUT",
        "-e",
        "ABS_FIXTURE_DIR",
        "-e",
        "ABS_EXTRA_HEADERS_FILE",
        "-e",
        "ABS_TLS_CA_CERT_FILE",
        "-e",
        "ABS_TLS_INSECURE_SKIP_VERIFY",
        "-e",
        "ABS_TRANSPORT",
        "-e",
        "ABS_HTTP_ADDR",
        "-e",
        "ABS_HTTP_PATH",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "your-value",
        "ABS_API_KEY": "your-value",
        "ABS_READ_ONLY": "your-value",
        "ABS_TIMEOUT": "your-value",
        "ABS_FIXTURE_DIR": "your-value",
        "ABS_EXTRA_HEADERS_FILE": "your-value",
        "ABS_TLS_CA_CERT_FILE": "your-value",
        "ABS_TLS_INSECURE_SKIP_VERIFY": "your-value",
        "ABS_TRANSPORT": "your-value",
        "ABS_HTTP_ADDR": "your-value",
        "ABS_HTTP_PATH": "your-value",
        "ABS_HTTP_BEARER_TOKEN": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "abs": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_READ_ONLY",
        "-e",
        "ABS_TIMEOUT",
        "-e",
        "ABS_FIXTURE_DIR",
        "-e",
        "ABS_EXTRA_HEADERS_FILE",
        "-e",
        "ABS_TLS_CA_CERT_FILE",
        "-e",
        "ABS_TLS_INSECURE_SKIP_VERIFY",
        "-e",
        "ABS_TRANSPORT",
        "-e",
        "ABS_HTTP_ADDR",
        "-e",
        "ABS_HTTP_PATH",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "your-value",
        "ABS_API_KEY": "your-value",
        "ABS_READ_ONLY": "your-value",
        "ABS_TIMEOUT": "your-value",
        "ABS_FIXTURE_DIR": "your-value",
        "ABS_EXTRA_HEADERS_FILE": "your-value",
        "ABS_TLS_CA_CERT_FILE": "your-value",
        "ABS_TLS_INSECURE_SKIP_VERIFY": "your-value",
        "ABS_TRANSPORT": "your-value",
        "ABS_HTTP_ADDR": "your-value",
        "ABS_HTTP_PATH": "your-value",
        "ABS_HTTP_BEARER_TOKEN": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ABS_BASE_URL required env
Base URL of your Audiobookshelf server.
ABS_API_KEY secret required env
Audiobookshelf API key or bearer token.
ABS_READ_ONLY env
Set to false to enable scan and cleanup tools.
ABS_TIMEOUT env
Audiobookshelf request timeout as a Go duration or seconds.
ABS_FIXTURE_DIR env
Optional local ABS fixture directory for fixture resources.
ABS_EXTRA_HEADERS_FILE env
Optional JSON file containing extra request headers.
ABS_TLS_CA_CERT_FILE env
Optional PEM CA bundle for private or corporate ABS TLS.
ABS_TLS_INSECURE_SKIP_VERIFY env
Temporary TLS verification bypass for local troubleshooting.
ABS_TRANSPORT env
MCP transport to run at startup. Use stdio for local launchers or http for Streamable HTTP.
ABS_HTTP_ADDR env
Bind address used when ABS_TRANSPORT=http.
ABS_HTTP_PATH env
Streamable HTTP endpoint path used when ABS_TRANSPORT=http.
ABS_HTTP_BEARER_TOKEN secret env
Optional bearer token required from Streamable HTTP MCP clients.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account jeeftor, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32489 servers in this category
Published to the registry more recently than 20% of the other 32489 servers in this category
Basic checks equal to or better than 100% of the other 32489 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Audiobookshelf MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.6.0) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Whisper

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

Whisper

by whisper-sec

One routable IPv6 per AI agent, verifiable from the DNS root. Keyless tools need no signup.

Computer or cloudUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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.

Highlights
Audiobook Organizer Compatibility
AI Generated Comparison - Last updated 2026-06-22
Quick Start
MCP Surface
Configuration
Safety
Installation
Client Configs
Local Development
Tests
CI and Releases
MCP Registry

Highlights

Read-only by default; scan and cleanup tools require ABS_READ_ONLY=false.
Ships as a local stdio MCP server from a single Go binary or Docker image, with optional Streamable HTTP mode for hosted or multi-client deployments.
Supports env vars, Docker-style env files, extra headers, and custom TLS CA bundles.
Includes source-backed Audiobookshelf API inventory resources and repeatable fixture tests.
Publishes release binaries and a GHCR image suitable for official MCP Registry metadata.

Audiobook Organizer Compatibility

I built this MCP server to work especially well alongside jeeftor/audiobook-organizer. While it exposes the normal Audiobookshelf MCP tools for inspecting libraries, items, metadata, and server state, one of its most useful workflows is auditing whether books are actually organized the way you expect on disk.

The abs_find_misorganized_items tool checks Audiobookshelf item paths against supported folder layout conventions, including author/title and author/series/title structures. It is audit-only, so it reports likely misconfigured or misplaced books without moving or deleting files. That makes it a good companion to Audiobook Organizer: use this MCP server to identify layout problems from Audiobookshelf's perspective, then use Audiobook Organizer to clean up or standardize the underlying files.

AI Generated Comparison - Last updated 2026-06-22

This comparison is generated from public GitHub repository metadata, public project READMEs, registry/package searches, and this repository's current docs. It is descriptive rather than a recommendation.

Mutating versus non-mutating coverage:

jeeftor/abs-mcp exposes read-only inspection, search, author, series, collection, current-user progress/bookmark/listening reads, backups, ereader device discovery, ebook send preview, metadata-object, layout-audit, resources, and prompts by default. Ebook device-send tools perform outbound delivery but do not mutate Audiobookshelf library, metadata, backup, progress, collection, or playlist state, so they remain usable in read-only mode. Scan, cleanup, cover, chapter, progress/bookmark writes, backup creation, metadata, and collection/playlist create/update/add/delete/remove tools can mutate Audiobookshelf state only when ABS_READ_ONLY=false; destructive operations also require exact confirmation strings.
michaeldvinci/audiobookshelf-mcp exposes a broad management surface with read tools plus mutating operations such as library, collection, playlist, progress, and backup actions. No public README evidence was found for a global default read-only gate during this pass.
sandymac/audiobookshelf-mcp is mostly read/query oriented, with optional progress and bookmark mutation tools that are disabled by default.
sierikov/audiobookshelf-mcp presents a read-only browsing, search, progress, stats, author, series, and collection surface.
ForceConstant/audiobookshelf_mcp appears to be generated from Audiobookshelf OpenAPI material; mutating coverage and safety gates were not determinable from the public README.

Sources checked in this pass:

Public GitHub repositories: michaeldvinci/audiobookshelf-mcp, sandymac/audiobookshelf-mcp, sierikov/audiobookshelf-mcp, ForceConstant/audiobookshelf_mcp, and schmidt-software/mcp-audiobookshelf.
Search checks for additional npm and PyPI packages did not surface a credible Audiobookshelf-specific MCP server beyond the GitHub targets above.

Server	Shape	Confirmed strengths	Safety posture	Difference from `jeeftor/abs-mcp`
`michaeldvinci/audiobookshelf-mcp`	Go stdio server with release binaries; GitHub metadata showed latest release `0.0.5` on 2025-11-11.	Broad general Audiobookshelf management, including libraries, items, authors, collections, playlists, user info, sessions, podcasts, progress updates, and backups.	Exposes mutating tools; no global default read-only gate was found in the public README during this comparison pass.	Broader generic management surface, but less conservative. This server overlaps more typed repair/catalog workflows now while adding default read-only gating, destructive confirmations, source-backed API inventory, MCP resources/prompts, organizer-oriented audit tooling, and fixture-backed behavior checks.
`sandymac/audiobookshelf-mcp`	Rust server with stdio plus HTTP/SSE support.	Read/query surface for libraries, search, progress, stats, recent sessions, and optional progress/bookmark mutations.	Mutating tools are disabled by default and must be explicitly enabled. HTTP mode recommends bearer auth and TLS proxying.	Similar safety model. It keeps the mutating surface narrow; this server adds source-backed API inventory, resources/prompts, organizer-oriented audits, fixture workflows, typed metadata/cover/chapter/catalog tools, and explicit destructive confirmations.
`sierikov/audiobookshelf-mcp`	Go server with read-oriented tooling, release binaries, `.mcpb` Claude Desktop bundles, and an MCP Registry entry.	Read-only browsing and search across libraries, items, progress, stats, sessions, series, authors, and collections.	Public README presents all tools as read-only with no writes, playback control, or user management.	Overlaps this server's read-only browsing surface, including progress, author, series, and collection reads, but no public evidence was found for controlled repair/catalog mutation workflows, source-backed API inventory, MCP prompts/resources, organizer-focused audit tooling, or Docker fixture workflows.
`ForceConstant/audiobookshelf_mcp`	Generated OpenAPI MCP bridge with Streamable HTTP on port 3000 and Docker-oriented files.	Broad generated API exposure from Audiobookshelf OpenAPI material.	Not determinable from the public README; generated API exposure may include mutating endpoints, but the README does not enumerate safety controls.	Less curated and less operator-specific. This project intentionally exposes bounded, typed tools with read-only gating and fixture-backed behavior checks instead of exposing every route directly.

Weak or placeholder hits, such as schmidt-software/mcp-audiobookshelf, were excluded when no implementation or feature evidence was available.

Candidate gaps from this comparison

Candidate: evaluate a bounded podcast workflow. Public peers expose podcast browsing or episode checks; this server currently has no dedicated podcast tools beyond generic item/library APIs.
Candidate: evaluate library creation/update workflows. One public peer exposes library creation, but this remains an admin-level operation that would need source verification, fixture coverage, ABS_READ_ONLY=false, and destructive confirmations for any delete/remove path.
Candidate: evaluate .mcpb desktop bundle packaging. One public peer ships Claude Desktop .mcpb bundles; this server currently publishes binaries, Docker/GHCR artifacts, and MCP Registry metadata instead.
Existing candidate still relevant: #5 tracks Streamable HTTP transport support. Public peers show both HTTP/SSE and Streamable HTTP shapes, so the issue should be reconciled with the current optional Streamable HTTP implementation and any remaining hardening or documentation gaps.

Quick Start

Run a downloaded release binary over MCP stdio:

ABS_BASE_URL=http://localhost:13378 \

ABS_API_KEY=... \ ABS_READ_ONLY=true \ /path/to/abs-mcp

Or run the container image:

docker run --rm -i \

-e ABS_BASE_URL=http://host.docker.internal:13378 \ -e ABS_API_KEY=... \ -e ABS_READ_ONLY=true \ ghcr.io/jeeftor/abs-mcp:0.5.0

For client-specific snippets, see Client Configs.

MCP Surface

Tools

The server exposes all registered tools in the README, grouped by whether they can change Audiobookshelf state.

Read-only and non-ABS-mutating tools:

abs_health_check
abs_list_libraries
abs_get_library
abs_list_library_items
abs_get_library_item
abs_search_library
abs_search_ebooks
abs_preview_ebook_device_send
abs_get_library_stats
abs_get_filter_data
abs_list_library_authors
abs_get_author
abs_list_library_series
abs_get_series
abs_list_collections
abs_get_collection
abs_get_items_in_progress
abs_get_listening_stats
abs_list_listening_sessions
abs_get_item_progress
abs_list_bookmarks
abs_list_backups
abs_list_ereader_devices
abs_send_ebook_to_device
abs_send_ebook_by_query
abs_get_item_metadata_object
abs_find_misorganized_items

Implemented mutating tools:

abs_scan_library
abs_scan_library_and_wait
abs_scan_item
abs_update_item_metadata
abs_update_item_progress
abs_create_bookmark
abs_update_bookmark
abs_create_backup
abs_update_item_cover
abs_remove_item_cover
abs_update_item_chapters
abs_create_collection
abs_update_collection
abs_delete_collection
abs_add_collection_item
abs_remove_collection_item
abs_create_playlist
abs_update_playlist
abs_delete_playlist
abs_add_playlist_item
abs_remove_playlist_item
abs_remove_library_items_with_issues

Planned mutating tools advertised for discovery:

abs_match_item
abs_update_item_tracks

Tools that mutate Audiobookshelf state are blocked by default because ABS_READ_ONLY defaults to true. Scan tools, issue cleanup, cover updates, chapter updates, typed item metadata, current-user progress/bookmark writes, backup creation, and collection/playlist create, update, add-item, delete, and remove-item tools are implemented mutating operations. Ebook send-to-device delivery and guarded query-based device send only email an already-existing ebook file out; they create, change, or delete nothing on Audiobookshelf (library, metadata, backup, progress, collection, or playlist state), so they are allowed while read-only mode is enabled. Read-only here means "does not mutate Audiobookshelf state," not "produces no outbound side effect"; if you need to suppress device delivery entirely, do not configure an ereader device. Use `abs_preview_ebook_device_s

Only the beginning is shown; read the rest in the repo

Audiobookshelf MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Whisper

README from the maker

Table of Contents

Highlights

Audiobook Organizer Compatibility

AI Generated Comparison - Last updated 2026-06-22

Candidate gaps from this comparison

Quick Start

MCP Surface

Tools