Audiobookshelf MCP Server: Install & Setup

Install Audiobookshelf in Claude Code

npm

Claude Code

claude mcp add audiobookshelf -e AUDIOBOOKSHELF_URL=... -e AUDIOBOOKSHELF_API_KEY=... -- npx -y audiobookshelf-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

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

Docker

Claude Code

claude mcp add audiobookshelf -e AUDIOBOOKSHELF_URL=... -e AUDIOBOOKSHELF_API_KEY=... -- docker run -i --rm -e AUDIOBOOKSHELF_URL -e AUDIOBOOKSHELF_API_KEY ghcr.io/ni-c/audiobookshelf-mcp:0.4.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "audiobookshelf": {
      "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": "...",
        "AUDIOBOOKSHELF_API_KEY": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Audiobookshelf MCP server do?

Browse an Audiobookshelf library, query listening history and stats, and sync progress, bookmarks, collections and playlists, with optional read-only mode.

Is the Audiobookshelf MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Audiobookshelf run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Audiobookshelf to Claude Code?

Run: claude mcp add audiobookshelf -e AUDIOBOOKSHELF_URL=... -e AUDIOBOOKSHELF_API_KEY=... -- npx -y audiobookshelf-mcp

More multimedia, audio & video MCP servers

View all

Botverse

1255

MkTurner74/botverse-mcp

Video transcoding (MP4, WebM, ProRes, GIF, MP3) and document conversion (PDF, DOCX, HTML, Markdown, XLSX) without AWS or FFmpeg setup.

LocalAccount neededTypeScript

Winston AI

gowinston-ai/winston-ai-mcp-server

AI detector MCP server with industry leading accuracy rates in detecting use of AI in text and images. The Winston AI MCP server also offers a robust plagiarism checker to help maintain integrity.

LocalFree

Gemini Media

mordor-forge/gemini-media-mcp

Gemini media generation: Nano Banana images and editing, Veo video, text-to-speech and Lyria music, via the Gemini API or Vertex AI.

LocalAccount neededGo

Voicely

StulkovLD/Voicely

Offline speech-to-text on macOS: transcribe audio/video files, read dictations and calls.

LocalFree

Slideshot

2239

06ketan/slideshot

Convert HTML into PDF, PNG, WebP or PPTX slide carousels with themes for LinkedIn, Instagram, pitch decks and infographics, rendered via Puppeteer.

LocalFreeTypeScript

One Design

0328

axworks1/one-design-mcp

Image, brand, privacy and PDF tools from one.design, run on your own computer. Nothing uploaded.

LocalFree