# 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](https://www.qobuz.com) 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](https://github.com/astral-sh/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`

```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](LICENSE).