English Français العربية

Audiobookshelf MCP

Official registry Media and design

Inspect and safely operate Audiobookshelf libraries over MCP.

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/jeeftor/abs-mcp:0.6.0
Claude Code 
claude mcp add audiobookshelf-mcp -e 'ABS_BASE_URL=<ABS_BASE_URL>' -e 'ABS_API_KEY=<your abs_api_key>' -e 'ABS_READ_ONLY=true' -e 'ABS_TIMEOUT=30s' -e 'ABS_FIXTURE_DIR=test/abs' -e 'ABS_EXTRA_HEADERS_FILE=<ABS_EXTRA_HEADERS_FILE>' -e 'ABS_TLS_CA_CERT_FILE=<ABS_TLS_CA_CERT_FILE>' -e 'ABS_TLS_INSECURE_SKIP_VERIFY=false' -e 'ABS_TRANSPORT=stdio' -e 'ABS_HTTP_ADDR=127.0.0.1:3333' -e 'ABS_HTTP_PATH=/mcp' -e 'ABS_HTTP_BEARER_TOKEN=<your abs_http_bearer_token>' -- docker run -i --rm ghcr.io/jeeftor/abs-mcp:0.6.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "audiobookshelf-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/jeeftor/abs-mcp:0.6.0"
            ],
            "env": {
                "ABS_BASE_URL": "<ABS_BASE_URL>",
                "ABS_API_KEY": "<your abs_api_key>",
                "ABS_READ_ONLY": "true",
                "ABS_TIMEOUT": "30s",
                "ABS_FIXTURE_DIR": "test/abs",
                "ABS_EXTRA_HEADERS_FILE": "<ABS_EXTRA_HEADERS_FILE>",
                "ABS_TLS_CA_CERT_FILE": "<ABS_TLS_CA_CERT_FILE>",
                "ABS_TLS_INSECURE_SKIP_VERIFY": "false",
                "ABS_TRANSPORT": "stdio",
                "ABS_HTTP_ADDR": "127.0.0.1:3333",
                "ABS_HTTP_PATH": "/mcp",
                "ABS_HTTP_BEARER_TOKEN": "<your abs_http_bearer_token>"
            }
        }
    }
}

Environment variables

  • ABS_BASE_URL required Base URL of your Audiobookshelf server.
  • ABS_API_KEY required secret Audiobookshelf API key or bearer token.
  • ABS_READ_ONLY Set to false to enable scan and cleanup tools.
  • ABS_TIMEOUT Audiobookshelf request timeout as a Go duration or seconds.
  • ABS_FIXTURE_DIR Optional local ABS fixture directory for fixture resources.
  • ABS_EXTRA_HEADERS_FILE Optional JSON file containing extra request headers.
  • ABS_TLS_CA_CERT_FILE Optional PEM CA bundle for private or corporate ABS TLS.
  • ABS_TLS_INSECURE_SKIP_VERIFY Temporary TLS verification bypass for local troubleshooting.
  • ABS_TRANSPORT MCP transport to run at startup. Use stdio for local launchers or http for Streamable HTTP.
  • ABS_HTTP_ADDR Bind address used when ABS_TRANSPORT=http.
  • ABS_HTTP_PATH Streamable HTTP endpoint path used when ABS_TRANSPORT=http.
  • ABS_HTTP_BEARER_TOKEN secret Optional bearer token required from Streamable HTTP MCP clients.

Frequently asked questions

What is Audiobookshelf MCP?

Inspect and safely operate Audiobookshelf libraries over MCP.

How do I install Audiobookshelf MCP?

It runs on your machine. In Claude Code: claude mcp add audiobookshelf-mcp -e 'ABS_BASE_URL=<ABS_BASE_URL>' -e 'ABS_API_KEY=<your abs_api_key>' -e 'ABS_READ_ONLY=true' -e 'ABS_TIMEOUT=30s' -e 'ABS_FIXTURE_DIR=test/abs' -e 'ABS_EXTRA_HEADERS_FILE=<ABS_EXTRA_HEADERS_FILE>' -e 'ABS_TLS_CA_CERT_FILE=<ABS_TLS_CA_CERT_FILE>' -e 'ABS_TLS_INSECURE_SKIP_VERIFY=false' -e 'ABS_TRANSPORT=stdio' -e 'ABS_HTTP_ADDR=127.0.0.1:3333' -e 'ABS_HTTP_PATH=/mcp' -e 'ABS_HTTP_BEARER_TOKEN=<your abs_http_bearer_token>' -- docker run -i --rm ghcr.io/jeeftor/abs-mcp:0.6.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Audiobookshelf MCP need an API key?

Yes. It expects ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN, which you set in its configuration.

Is Audiobookshelf MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Audiobookshelf MCP?

It is published by jeeftor. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.