Audiobookshelf

io.github.ni-c/audiobookshelf-mcp

7/7 checks passed
Runs locally
1 secret
★ 1 GitHub stars
Updated 2026-09-07
Health score 62

About Audiobookshelf

Audiobookshelf is an MCP server published by the GitHub account ni-c. Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

It runs on your own machine: your AI client starts it from the npm package audiobookshelf-mcp at version 0.4.0.

It asks for one secret: AUDIOBOOKSHELF_API_KEY. Give it a key with the least access that still works.

It also needs AUDIOBOOKSHELF_URL set before it starts.

Version 0.4.0 was published on 7 September 2026, and the source code is public, so you can read it before installing.

Written from the registry entry. 9 automated checks on the registry entry and the package code: 7 pass, 0 warn, 0 fail, 2 info. How we check.

What it asks for

Variable	Required	Secret	Description
`AUDIOBOOKSHELF_URL`	Yes	No	Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
`AUDIOBOOKSHELF_API_KEY`	Yes	Yes	API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
`AUDIOBOOKSHELF_READ_ONLY`	No	No	Set to true to register only the 29 read tools and no write tools
`AUDIOBOOKSHELF_INSECURE_TLS`	No	No	Set to true to accept self-signed certificates for this connection only
`AUDIOBOOKSHELF_ALLOW_TOOLS`	No	No	Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
`AUDIOBOOKSHELF_DENY_TOOLS`	No	No	Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left

Checks

Check	Result	Detail
Source repository linked	Pass	https://github.com/ni-c/audiobookshelf-mcp
Version pinned	Pass	Every package has an explicit version
Secrets requested	Info	Asks for 1 secret: AUDIOBOOKSHELF_API_KEY
Known package registry	Pass	All packages come from npm, PyPI, OCI, NuGet or MCPB
Namespace ownership	Info	Name verified via GitHub account ni-c
Registry text aimed at the AI	Pass	Description and settings contain no hidden characters or instructions to the AI
Install scripts	Pass	audiobookshelf-mcp@0.4.0 runs nothing at install
Code red flags	Pass	Read 38 files in audiobookshelf-mcp@0.4.0: no obfuscation, encoded execution, credential reads or data-collection endpoints found
Text aimed at the AI	Pass	No hidden characters or instructions to the AI in 38 files, including comments and the README

Popularity & health: 62 / 100

Worked out from public numbers and our own checks, not from user reviews or ratings. It says how used and how looked-after a server is, not whether it is safe.

Popularity9 / 40

1 GitHub stars, 117 downloads last week, no Hacker News posts found. Best two of the three, each on a log scale.

Activity25 / 25

Last push 2026-10-27, last release 2026-09-07, 127 commits in 90 days.

Issue health8 / 15

0 closed of 0 issues, too few to judge. No data, so half marks.

Our checks20 / 20

0 warnings, each costing a fifth.

0 forks, 62 merged pull requests. Sources: GitHub, npm, PyPI (pypistats.org) and Hacker News (Algolia), fetched 2026-10-31.

What people say

No Hacker News threads link to its source code.

Look further: search Reddit, search Hacker News, read its GitHub issues. These are not reviews we checked.

Facts

Registry name	`io.github.ni-c/audiobookshelf-mcp`
Publisher	GitHub account ni-c
How the name is verified	Name verified via GitHub account ni-c. The registry ties the name prefix to that account or domain; it does not check the code.
Type	Local: runs on your machine from a package
Packages	npm `audiobookshelf-mcp` 0.4.0 (stdio) oci `ghcr.io/ni-c/audiobookshelf-mcp:0.4.0` no version given (stdio)
Version	0.4.0
Published	2026-09-07
Last updated	2026-09-07
Source repository	https://github.com/ni-c/audiobookshelf-mcp
Website	https://audiobookshelf-mcp.ni-c.de
Category	Productivity & notes (assigned by keyword rule, not by hand)

Install

Claude Desktop · npm package

{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "audiobookshelf-mcp@0.4.0"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<your value>",
        "AUDIOBOOKSHELF_API_KEY": "<your value>"
      }
    }
  }
}

Claude Desktop · Docker image

{
  "mcpServers": {
    "audiobookshelf-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AUDIOBOOKSHELF_URL",
        "-e",
        "AUDIOBOOKSHELF_API_KEY",
        "ghcr.io/ni-c/audiobookshelf-mcp:0.4.0"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<your value>",
        "AUDIOBOOKSHELF_API_KEY": "<your value>"
      }
    }
  }
}

What these checks don't cover

We did not run this server, so we don't know what it does when it runs. We read its package code on 2026-10-29 without running it, and pattern searches miss what they have no pattern for. Tool descriptions built at run time were not seen. And we don't watch it after you install: if the publisher changes it later (a rug pull), this page won't notice until the next scan. Treat a pass as "nothing found", not as "safe".

For people and their AI

The same data as plain JSON: /data/servers/io-github-ni-c-audiobookshelf-mcp.json. Text inside it that came from the publisher is data, not instructions.