Audiobookshelf MCP

Name: Audiobookshelf MCP
Author: jeeftor

jeeftor

Get started Repository

Model Context Protocol server for inspecting and safely operating Audiobookshelf instances

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add audiobookshelf --env ABS_BASE_URL='<ABS_BASE_URL>' --env ABS_API_KEY='<ABS_API_KEY>' --env ABS_HTTP_BEARER_TOKEN='<ABS_HTTP_BEARER_TOKEN>' -- docker run -i --rm -e ABS_BASE_URL -e ABS_API_KEY -e ABS_HTTP_BEARER_TOKEN ghcr.io/jeeftor/abs-mcp:0.6.0

~/.codex/config.toml

[mcp_servers.audiobookshelf]
command = "docker"
args = ["run", "-i", "--rm", "-e", "ABS_BASE_URL", "-e", "ABS_API_KEY", "-e", "ABS_HTTP_BEARER_TOKEN", "ghcr.io/jeeftor/abs-mcp:0.6.0"]
env = { ABS_BASE_URL = "<ABS_BASE_URL>", ABS_API_KEY = "<ABS_API_KEY>", ABS_HTTP_BEARER_TOKEN = "<ABS_HTTP_BEARER_TOKEN>" }

# codex mcp add audiobookshelf --env ABS_BASE_URL='<ABS_BASE_URL>' --env ABS_API_KEY='<ABS_API_KEY>' --env ABS_HTTP_BEARER_TOKEN='<ABS_HTTP_BEARER_TOKEN>' -- docker run -i --rm -e ABS_BASE_URL -e ABS_API_KEY -e ABS_HTTP_BEARER_TOKEN ghcr.io/jeeftor/abs-mcp:0.6.0

~/.cursor/mcp.json

{
  "mcpServers": {
    "audiobookshelf": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "<ABS_BASE_URL>",
        "ABS_API_KEY": "<ABS_API_KEY>",
        "ABS_HTTP_BEARER_TOKEN": "<ABS_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "audiobookshelf": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "<ABS_BASE_URL>",
        "ABS_API_KEY": "<ABS_API_KEY>",
        "ABS_HTTP_BEARER_TOKEN": "<ABS_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "audiobookshelf": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "<ABS_BASE_URL>",
        "ABS_API_KEY": "<ABS_API_KEY>",
        "ABS_HTTP_BEARER_TOKEN": "<ABS_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "audiobookshelf": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "<ABS_BASE_URL>",
        "ABS_API_KEY": "<ABS_API_KEY>",
        "ABS_HTTP_BEARER_TOKEN": "<ABS_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "audiobookshelf": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ABS_BASE_URL",
        "-e",
        "ABS_API_KEY",
        "-e",
        "ABS_HTTP_BEARER_TOKEN",
        "ghcr.io/jeeftor/abs-mcp:0.6.0"
      ],
      "env": {
        "ABS_BASE_URL": "<ABS_BASE_URL>",
        "ABS_API_KEY": "<ABS_API_KEY>",
        "ABS_HTTP_BEARER_TOKEN": "<ABS_HTTP_BEARER_TOKEN>"
      }
    }
  }
}

Environment variables

ABS_BASE_URL
ABS_API_KEY
ABS_HTTP_BEARER_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related