MCP server for the Qobuz music streaming service
Project description
qobuz-mcp
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
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": "798273057",
"QOBUZ_APP_SECRET": "abb21364945c0583309667d13ca3d93a",
"QOBUZ_USERNAME": "your@email.com",
"QOBUZ_PASSWORD": "your_password"
}
}
}
}
Restart Claude Desktop and you're ready to go.
Note: The
app_idandapp_secretabove are extracted from Qobuz's own web player and are provided here for convenience. If they stop working, up-to-date values can be found in open-source clients such as streamrip.
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qobuz_mcp-0.1.0.tar.gz.
File metadata
- Download URL: qobuz_mcp-0.1.0.tar.gz
- Upload date:
- Size: 21.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
253f1c8fd1f5107bca77703e0ff74aa30071c70f10a7e2068e1563d281d02a5f
|
|
| MD5 |
a5adcd983820d544c19bbcb4c8b16496
|
|
| BLAKE2b-256 |
76daef415c93b6e44c14f60c840ca8c5ebccb2e1fb983bc658fe19d9623530a5
|
File details
Details for the file qobuz_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: qobuz_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 19.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f3a1e799714d52535f513dfbcab7ccd063ead44b8ae2de4bd016b6351d2c1dfa
|
|
| MD5 |
1944ca902e0d308f0d6b069a1a9b61c1
|
|
| BLAKE2b-256 |
96f79392528c0466befcc80754f5b2f8954662fff6427ecee64df8143eb74c0d
|