LABSCO SUMMARY
The remote connector is three clicks; the CLI is what makes it scriptable.
Most people will want the hosted server — a URL, an OAuth login, done. The CLI matters for the other case: --json on every command means an agent can chain search into playlist-building through jq, and tokens refresh automatically so non-interactive runs keep working after the first auth. Adding a whole album to a playlist in one call is the kind of small thing that saves a loop.
What it is
A wrapper around the Tidal API v2, shipped two ways: a command-line tool where every command takes --json, and a remote MCP server for Claude Desktop and other clients.
What you get
- 40 tools over the remote server, with OAuth authentication, safety annotations and 3 prompt templates
- Search across artists, albums, tracks, videos and playlists, plus autocomplete suggestions and editorial search
- Artists — info, top tracks, discography, similar artists and radio; albums by ID or barcode; tracks by ID, ISRC, similar or radio
- Playlists get full CRUD: create, rename, set description, delete, add and remove tracks, reorder, and add an entire album at once
- Library favourites for artists, albums, tracks, videos and playlists
- Recommendations — Daily, Discovery, New Release and Offline mixes — with drill-down into the items inside a mix
- History for recently added tracks, albums and artists, plus search history you can list, delete or clear
- Save for Later as a separate queue from your library; share links for tracks and albums
- Playback: stream info, direct URLs and local playback, with LOW, HIGH, LOSSLESS and HI_RES quality options
Requirements
For the remote server, nothing local: add https://tidal-cli.lucaperret.ch/api/mcp as a custom connector and log in to Tidal. For the CLI, npm install -g @lucaperret/tidal-cli with Node.js 20 or newer, then tidal-cli auth once — it opens your browser. A Tidal account either way. It is also published as an OpenClaw skill on ClawHub.
Setup effort
Add the hosted endpoint, then sign in — paste it into your client, then approve the OAuth sign-in
USE CASES
01
Building a playlist from a description
Search for the artists, pull their top tracks, and add them without opening the app.
02
Finding your way out of a rut
Ask for artists similar to one you like and drill into a Discovery mix.
03
Playing something right now
Resolve the track and play it locally at the quality you want.
04
Scripting library maintenance
Pipe JSON output through jq to favourite, save or reorder in bulk.
BEFORE YOU INSTALL
What to know first
Requires
A Tidal account
INSTALLATION
Connect your client
Server setup
ENDPOINT URL
https://tidal-cli.lucaperret.ch/api/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Desktop
Settings → Connectors → Add custom connector
Enter https://tidal-cli.lucaperret.ch/api/mcp
Click "Connect" → log in to Tidal