mcp-deezer

Unofficial Deezer MCP server for AI agents. Search music, manage playlists and favorites, and access personalized discovery through 29 tools.

Why this exists

Deezer closed their developer portal to new applications in 2025. This project uses an authenticated browser session through Deezer's internal GraphQL API instead of a developer API key.

Because the API is unofficial, it can change without notice. This project is not affiliated with or endorsed by Deezer.

Related MCP server: mcp-spotify

For AI Agents — Installation Guide

If you are an AI agent reading this to install mcp-deezer for a user, follow these steps in order:

Step 1: Check prerequisites

• Python 3.12+ must be installed (python3 --version or python --version)

• If not installed, tell the user to install it from https://www.python.org/downloads/

Step 2: Install the package

Until the first PyPI release, install directly from GitHub:

pip install "mcp-deezer @ git+https://github.com/Benitoow/mcp-deezer.git"

Or run it with uvx without a persistent installation:

uvx --from git+https://github.com/Benitoow/mcp-deezer.git mcp-deezer

Step 3: Get the user's Deezer ARL cookie

The user must do this manually in their browser:

1. Go to https://deezer.com and log in

2. Press F12 → Application → Cookies → deezer.com

3. Find the cookie named arl and copy its value (~192 character hex string)

The ARL looks like: a1b2c3d4e5f6... (192 hex chars)

Step 4: Configure the MCP server

Add this to the user's MCP client config. The DEEZER_ARL environment variable is required.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "deezer": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Benitoow/mcp-deezer.git", "mcp-deezer"],
      "env": {
        "DEEZER_ARL": "PASTE_ARL_HERE"
      }
    }
  }
}

Claude Code — terminal:

claude mcp add deezer -e DEEZER_ARL=PASTE_ARL_HERE -- uvx --from git+https://github.com/Benitoow/mcp-deezer.git mcp-deezer

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "deezer": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Benitoow/mcp-deezer.git", "mcp-deezer"],
      "env": {
        "DEEZER_ARL": "PASTE_ARL_HERE"
      }
    }
  }
}

Hermes Agent — ~/.hermes/config.yaml:

mcp_servers:
  deezer:
    command: uvx
    args: [--from, git+https://github.com/Benitoow/mcp-deezer.git, mcp-deezer]
    env:
      DEEZER_ARL: "PASTE_ARL_HERE"

VS Code / Copilot — .vscode/mcp.json:

{
  "servers": {
    "deezer": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Benitoow/mcp-deezer.git", "mcp-deezer"],
      "env": {
        "DEEZER_ARL": "PASTE_ARL_HERE"
      }
    }
  }
}

Step 5: Restart the MCP client

Tell the user to restart their AI client (Claude Desktop, Cursor, etc.) for the server to load.

Step 6: Verify

Call get_me — it should return the user's Deezer profile ID. If it returns an error about DEEZER_ARL, the cookie is missing or expired.

Available Tools (29)

How It Works

AI Agent  ←── MCP (stdio) ──→  mcp-deezer  ←── GraphQL ──→  Deezer API
                                    │
                              ARL cookie (your session)

Uses deezer-python-gql, an unofficial client for Deezer's internal GraphQL API. Authentication uses the ARL session cookie stored in your browser.

FAQ (for agents)

Q: The user's ARL stopped working. A: Tell them to log out and back in to deezer.com, then grab the new arl cookie.

Q: Does this work with a free Deezer account? A: Yes. Unlike Spotify's API, Deezer works with free accounts.

Q: Is this against Deezer's ToS? A: This project is unofficial and uses Deezer's internal web API. Review Deezer's current terms and use it only with an account and content you are authorized to access.

Q: Python 3.12+ is not available. A: Install it from https://www.python.org/downloads/ or use uvx which manages its own Python.

License

MIT

Project health

• Changes: CHANGELOG.md

• Contributing: CONTRIBUTING.md

• Security and ARL handling: SECURITY.md