Skip to main content
Open Source CLI for Tidal
AI Agent Ready

Tidal from
your terminal

Search, play, and manage your Tidal library with a single command. Built for developers, designed for LLM agent automation.

Get StartedInstall on ClawHubGitHub
tidal-cli
$ tidal-cli search track "Around the World"
Search results for "Around the World" (tracks):
[5756235] Around the World — Daft Punk (7:27, LOSSLESS)
[5756236] Around the World — Daft Punk (Radio Edit) (3:58)
[92847103] Around the World — Moderat (4:12)
$ tidal-cli playback play 5756235
Downloading track 5756235 (LOSSLESS, FLAC)...
Playing... Press Ctrl+C to stop.

Everything you need

Full control over your Tidal experience, all from the command line.

Search

Search the entire Tidal catalog — artists, albums, tracks, videos, and playlists.

$ search artist "Gorillaz"
$ search track "Teardrop"
$ search video "Stylo"
$ search playlist "Electronic"

Artist & Track

Explore artist info, full discography, and detailed track metadata including ISRC, BPM, and key.

$ artist info <id>
$ artist albums <id>
$ track info <id>

Discovery

Find similar artists and tracks, or get personalized recommendations from your listening history.

$ artist similar <id>
$ track similar <id>
$ recommend

Playlists

Create, rename, delete playlists. Add or remove tracks and entire albums.

$ playlist list
$ playlist create --name "Chill"
$ playlist add-album ...

Playback

Play tracks locally, get stream URLs, or inspect playback quality.

$ playback play 5756235
$ playback url 5756235
$ playback info 5756235

Library

Manage your favorites. Add or remove artists, albums, tracks, and videos.

$ library add --track-id ...
$ library favorite-playlists
$ history tracks

Ready in two commands

Install, sign in. That's it.

Installation
$ npm install -g @lucaperret/tidal-cli
# Sign in with your Tidal account
$ tidal-cli auth
Opening browser for Tidal authorization...
Authenticated successfully! User ID: 123456789
# You're ready — start exploring
$ tidal-cli search track "Teardrop"
MCP Connector

Works with Claude

Connect your Tidal account to Claude Desktop or claude.ai. No install needed — just add the connector URL.

1

Add the connector

Settings → Connectors → Add custom connector

https://tidal-cli.lucaperret.ch/api/mcp
2

Connect your Tidal account

Click “Connect” and sign in with your Tidal credentials. OAuth keeps your password safe.

3

Ask Claude anything about music

32 tools available — search, playlists, library, recommendations, and more.

Also available on Smithery →
AI Agent

Just ask your agent

Tell your AI what you want. It handles the rest.

Create a playlist with the best tracks from Daft Punk's Discovery album

Searches, creates playlist, adds tracks

Find artists similar to Massive Attack and add their top tracks to my library

Discovers similar artists, adds to favorites

What are my playlists? Add the new LCD Soundsystem album to the first one

Lists playlists, searches album, adds tracks

Play me something by Boards of Canada

Searches, picks a track, plays it

Build a 2000s indie rock playlist with The Strokes, Arctic Monkeys, and Interpol

Multi-step: create, search, add tracks

AI Agent Skill

Built for
AI automation

Every command supports --json output for machine-readable responses. Available as a skill on ClawHub, tidal-cli lets LLM agents search, curate playlists, and control playback programmatically.

$ clawhub install tidal-cli
  • ✓JSON output on every command
  • ✓Non-interactive after initial auth
  • ✓Auto-refreshing tokens
  • ✓Available on ClawHub
JSON output
$ tidal-cli --json playlist list
[{
"id": "a20fff4a-...",
"name": "Late Night Electronic",
"numberOfItems": 24,
"createdAt": "2025-04-20T..."
}, ...]