qobuz-mcp

Disclaimer: This is a personal research project and technical demo exploring MCP server development. It is not authorized, endorsed, or affiliated with Qobuz in any way, and is not intended for production use.

The author contacted Qobuz to request authorisation. Their response was: "Our API is not public. Access is granted only to professional partners as part of a commercial or technical integration. Due to our licensing agreements with major labels, we are not allowed to provide a public API or support open source integrations."

This repository is kept private and the PyPI package has been yanked accordingly. The code is preserved here for personal reference and learning only.

Connect your Qobuz account to Claude. Search music, manage playlists, browse your favorites, and get streaming URLs - all through conversation.

Requirements

• An active Qobuz paid subscription (email/password login - Google OAuth accounts are not supported)
• uv installed
• A Qobuz app ID and app secret (obtainable through your own research)

Installation

Add this to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "qobuz": {
      "command": "uvx",
      "args": ["qobuz-mcp"],
      "env": {
        "QOBUZ_APP_ID": "your_app_id",
        "QOBUZ_APP_SECRET": "your_app_secret",
        "QOBUZ_USERNAME": "your@email.com",
        "QOBUZ_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Desktop and you're ready to go.

What you can do

Once connected, just talk to Claude naturally.

Search & browse

• "Search for albums by Radiohead"
• "Find the track 'Pyramids' by Frank Ocean"
• "Show me the tracklist for OK Computer"
• "Tell me about the artist Nils Frahm - how many albums does he have?"
• "Show me all studio albums by Nick Cave"

Discovery

• "What are Qobuz's new releases this week?"
• "Show me the best-selling albums right now"
• "What are the editor's picks in jazz?"
• "List all available genres"
• "Show me press award winners in classical music"

Favorites

• "Show my favorite tracks"
• "Add OK Computer to my favorite albums"
• "Like the artist Floating Points"
• "Remove this track from my favorites"
• "What albums have I saved?"

Playlists

• "Show all my playlists"
• "Create a playlist called 'Late Night' with a description"
• "Add these three tracks to my Morning Run playlist"
• "Show me what's in my Workout playlist"
• "Rename my playlist to 'Road Trip'"
• "Remove the second track from this playlist"
• "Delete my old playlist"

Streaming

• "Get me a streaming URL for this track in Hi-Res"
• "Give me a CD-quality link for that song"

Note: Streaming URLs are time-limited and expire after a few minutes. Hi-Res formats (24-bit) require a Qobuz Hi-Res subscription - ask for CD quality if you're on a standard plan.

License

MIT - see LICENSE.