Audiobookshelf

Registre officiel Médias et design

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package audiobookshelf-mcp
Claude Code
claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- npx -y audiobookshelf-mcp@0.4.0
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "audiobookshelf": {
            "command": "npx",
            "args": [
                "-y",
                "audiobookshelf-mcp@0.4.0"
            ],
            "env": {
                "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
                "AUDIOBOOKSHELF_API_KEY": "<your audiobookshelf_api_key>",
                "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
                "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
                "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
                "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
            }
        }
    }
}

Variables d'environnement

  • AUDIOBOOKSHELF_URL obligatoire Base URL of the Audiobookshelf instance, e.g. https://abs.example.com
  • AUDIOBOOKSHELF_API_KEY obligatoire secret API key from Settings -> Users -> API Keys (Audiobookshelf 2.26.0 or newer)
  • AUDIOBOOKSHELF_READ_ONLY Set to true to register only the 29 read tools and no write tools
  • AUDIOBOOKSHELF_INSECURE_TLS Set to true to accept self-signed certificates for this connection only
  • AUDIOBOOKSHELF_ALLOW_TOOLS Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
  • AUDIOBOOKSHELF_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever AUDIOBOOKSHELF_ALLOW_TOOLS left
OCI package ghcr.io/ni-c/audiobookshelf-mcp:0.4.0
Claude Code
claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- docker run -i --rm ghcr.io/ni-c/audiobookshelf-mcp:0.4.0
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "audiobookshelf": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/ni-c/audiobookshelf-mcp:0.4.0"
            ],
            "env": {
                "AUDIOBOOKSHELF_URL": "<AUDIOBOOKSHELF_URL>",
                "AUDIOBOOKSHELF_API_KEY": "<your audiobookshelf_api_key>",
                "AUDIOBOOKSHELF_READ_ONLY": "<AUDIOBOOKSHELF_READ_ONLY>",
                "AUDIOBOOKSHELF_INSECURE_TLS": "<AUDIOBOOKSHELF_INSECURE_TLS>",
                "AUDIOBOOKSHELF_ALLOW_TOOLS": "<AUDIOBOOKSHELF_ALLOW_TOOLS>",
                "AUDIOBOOKSHELF_DENY_TOOLS": "<AUDIOBOOKSHELF_DENY_TOOLS>"
            }
        }
    }
}

Variables d'environnement

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

Questions fréquentes

Qu'est-ce que Audiobookshelf ?

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

Comment installer Audiobookshelf ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add audiobookshelf -e 'AUDIOBOOKSHELF_URL=<AUDIOBOOKSHELF_URL>' -e 'AUDIOBOOKSHELF_API_KEY=<your audiobookshelf_api_key>' -e 'AUDIOBOOKSHELF_READ_ONLY=<AUDIOBOOKSHELF_READ_ONLY>' -e 'AUDIOBOOKSHELF_INSECURE_TLS=<AUDIOBOOKSHELF_INSECURE_TLS>' -e 'AUDIOBOOKSHELF_ALLOW_TOOLS=<AUDIOBOOKSHELF_ALLOW_TOOLS>' -e 'AUDIOBOOKSHELF_DENY_TOOLS=<AUDIOBOOKSHELF_DENY_TOOLS>' -- npx -y audiobookshelf-mcp@0.4.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Audiobookshelf ?

Oui. Il attend AUDIOBOOKSHELF_URL, AUDIOBOOKSHELF_API_KEY, à renseigner dans sa configuration.

Audiobookshelf est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Audiobookshelf ?

Il est publié par ni-c. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.