How do I install tidal-cli?

Run `npm install -g @lucaperret/tidal-cli`, then `tidal-cli auth` to connect your Tidal account.

Can tidal-cli be used with LLM agents?

Yes, tidal-cli is designed for LLM agent automation. Install the skill via OpenClaw or skills.sh for seamless integration with Claude Code, Codex, and other AI coding agents.

Yes, tidal-cli is free and open-source under the MIT license. You need a Tidal subscription to access the music catalog.

← Back to home

Privacy Policy

Name: tidal-cli
Author: Luca Perret

Last updated: March 18, 2026

By Luca Perret

Overview

tidal-cli is an open-source command-line tool that lets you interact with your Tidal account. It is designed for personal use and LLM agent automation. Your privacy is important to us.

Data We Collect

tidal-cli does not collect, store, or transmit any personal data to us beyond what is necessary to operate the service.

CLI (Command-Line Interface)

When using tidal-cli as a command-line tool, it communicates directly between your device and Tidal's API servers. No data passes through any intermediary server. Authentication tokens are stored locally on your device at ~/.tidal-cli/session.json.

MCP Server (Claude Integration)

When using tidal-cli as an MCP connector (e.g., through Claude Desktop or claude.ai), authentication tokens are stored server-side in an encrypted Redis database hosted on Upstash (via Vercel). This is required to maintain your Tidal session across requests in a serverless environment.

Tidal OAuth tokens are stored per-user with a 30-day TTL
Tokens are used exclusively to call the Tidal API on your behalf
No music content, playlists, or listening history is stored on our servers
You can revoke access at any time from your Tidal account settings

Authentication

Both the CLI and MCP server use OAuth 2.0 Authorization Code flow with PKCE to authenticate with Tidal. Your Tidal username and password are never seen or stored by tidal-cli — you authenticate directly with Tidal.

Data Storage

CLI: OAuth tokens in ~/.tidal-cli/session.json (local only)
MCP: OAuth tokens in Upstash Redis (encrypted, 30-day TTL)
No analytics, telemetry, or tracking
No cookies on this website (except those set by Tidal during OAuth)

Third-Party Services

tidal-cli communicates with the following services:

Tidal API (openapi.tidal.com) — to access your music library, playlists, and catalog. Subject to Tidal's Privacy Policy
Tidal Auth (login.tidal.com, auth.tidal.com) — for OAuth authentication

Open Source

tidal-cli is fully open source. You can inspect the source code to verify these claims at github.com/lucaperret/tidal-cli.

Data Deletion

To remove all locally stored data, delete the session file:

$ rm -rf ~/.tidal-cli

You can also revoke tidal-cli's access from your Tidal account settings.

Contact

For questions about this privacy policy, open an issue on GitHub.

← Home Terms of Service →