Skip to content
MCP server

Audiobookshelf

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.4.0
Listing updated
5 days ago

About Audiobookshelf

Audiobookshelf is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Browse your Audiobookshelf libraries and keep listening progress, bookmarks and playlists in sync

Install

Run in a terminal

claude mcp add audiobookshelf-mcp --env AUDIOBOOKSHELF_URL='<AUDIOBOOKSHELF_URL>' --env AUDIOBOOKSHELF_API_KEY='<AUDIOBOOKSHELF_API_KEY>' -- npx -y audiobookshelf-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "audiobookshelf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "audiobookshelf-mcp"
      ],
      "env": {
        "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
        "AUDIOBOOKSHELF_API_KEY": "<AUDIOBOOKSHELF_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • AUDIOBOOKSHELF_URLBase URL of the Audiobookshelf instance, e.g. https://abs.example.comRequired
  • AUDIOBOOKSHELF_API_KEYAPI key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)Required
  • AUDIOBOOKSHELF_READ_ONLYSet to true to register only the 29 read tools and no write tools
  • AUDIOBOOKSHELF_INSECURE_TLSSet to true to accept self-signed certificates for this connection only
  • AUDIOBOOKSHELF_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • AUDIOBOOKSHELF_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left
  • AUDIOBOOKSHELF_URLBase URL of the Audiobookshelf instance, e.g. https://abs.example.comRequired
  • AUDIOBOOKSHELF_API_KEYAPI key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)Required
  • AUDIOBOOKSHELF_READ_ONLYSet to true to register only the 29 read tools and no write tools
  • AUDIOBOOKSHELF_INSECURE_TLSSet to true to accept self-signed certificates for this connection only
  • AUDIOBOOKSHELF_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • AUDIOBOOKSHELF_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left

Pricing

Open source

Prices change. Check audiobookshelf-mcp.ni-c.de before you buy.

Audiobookshelf FAQ

Is Audiobookshelf free?

Yes. Audiobookshelf is open source, so you can use and self-host it for free.

How do I add Audiobookshelf to Claude Code?

Run this command in your terminal: claude mcp add audiobookshelf-mcp --env AUDIOBOOKSHELF_URL='<AUDIOBOOKSHELF_URL>' --env AUDIOBOOKSHELF_API_KEY='<AUDIOBOOKSHELF_API_KEY>' -- npx -y audiobookshelf-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers