Skip to main content

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_id and app_secret above 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qobuz_mcp-0.1.0.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qobuz_mcp-0.1.0-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

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

Hashes for qobuz_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 253f1c8fd1f5107bca77703e0ff74aa30071c70f10a7e2068e1563d281d02a5f
MD5 a5adcd983820d544c19bbcb4c8b16496
BLAKE2b-256 76daef415c93b6e44c14f60c840ca8c5ebccb2e1fb983bc658fe19d9623530a5

See more details on using hashes here.

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

Hashes for qobuz_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f3a1e799714d52535f513dfbcab7ccd063ead44b8ae2de4bd016b6351d2c1dfa
MD5 1944ca902e0d308f0d6b069a1a9b61c1
BLAKE2b-256 96f79392528c0466befcc80754f5b2f8954662fff6427ecee64df8143eb74c0d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page