Audiobookshelf MCP

Name: Audiobookshelf MCP
Author: jeeftor

de jeeftorversión 0.6.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.jeeftor/abs-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

Inspect and safely operate Audiobookshelf libraries over MCP.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: 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

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

DockerDocker instalado

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en 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"
      }
    }
  }
}

Ejecuta esto en tu 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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

ABS_BASE_URL obligatorio env
Base URL of your Audiobookshelf server.
ABS_API_KEY secreto obligatorio 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 secreto env
Optional bearer token required from Streamable HTTP MCP clients.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub jeeftor, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32466 servidores de esta categoría
Publicado en el registro más recientemente que el 20% de los otros 32466 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32466 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Audiobookshelf MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.6.0) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, HotCodePush

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

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

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

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

Se ejecuta en la nube★ 211Actualizado ayer

Instalar

HotCodePush

de hotcodepush-team

Manage over-the-air (OTA) updates for React Native, Expo, Capacitor and Cordova apps.

Se ejecuta en la nubeActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Solo se muestra el principio; lee el resto en el repo

Audiobookshelf MCP

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

HotCodePush

README del creador

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