Audiobookshelf MCP

Name: Audiobookshelf MCP
Author: jeeftor

作者：jeeftorバージョン 0.6.0i★ –iパソコンで動く

レジストリ名io.github.jeeftor/abs-mcp

インストール

概要

作者による説明（英語の原文）

Inspect and safely operate Audiobookshelf libraries over MCP.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他
入力が必要なもの：ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： 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

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

DockerDockerのインストール

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、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"
      }
    }
  }
}

ターミナルでこれを実行します

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

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.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"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

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

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント jeeftor で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32466件のうち0%よりスターが多い
このカテゴリのほかの32466件のうち20%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32466件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Audiobookshelf MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.6.0）がレジストリに届いたのは3 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, HotCodePush

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

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

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

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

クラウドで動く★ 211昨日更新

インストール

HotCodePush

作者：hotcodepush-team

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

クラウドで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます

Audiobookshelf MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

HotCodePush

作者のREADME

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