TidalCAUTION
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Most music platforms offer recommendations — Daily Discovery, Top Artists, New Arrivals, etc. — but even with the state-of-the-art system, they often feel too "aggregated". I wanted something more custom and context-aware.
With TIDAL MCP, you can ask for things like:
"Based on my last 10 favorites, find similar tracks — but only ones from recent years." "Find me tracks like those in this playlist, but slower and more acoustic."
The LLM filters and curates results using your input, finds similar tracks via TIDAL’s API, and builds new playlists directly in your account.
Features
- 🌟 Music Recommendations: Get personalized track recommendations based on your listening history plus your custom criteria.
- ၊၊||၊ Playlist Management: Create, view, and manage your TIDAL playlists
Quick Start
Prerequisites
- Python 3.10+
- uv (Python package manager)
- TIDAL subscription
Installation
- Clone this repository:
git clone https://github.com/yuhuacheng/tidal-mcp.git cd tidal-mcp
- Create a virtual environment and install dependencies using uv:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
- Install the package with all dependencies from the pyproject.toml file:
uv pip install --editable .
This will install all dependencies defined in the pyproject.toml file and set up the project in development mode.
MCP Client Configuration
Claude Desktop Configuration
To add this MCP server to Claude Desktop, you need to update the MCP configuration file. Here's an example configuration: (you can s
2931adcd4082OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add tidal-mcp -- uvx tidal-mcp
{
"mcpServers": {
"tidal-mcp": {
"command": "uvx",
"args": [
"tidal-mcp"
]
}
}
}Exposed tools (7)
5 read · 1 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
create_tidal_playlist | write | |
delete_tidal_playlist | destructive | |
get_favorite_tracks | read | |
get_playlist_tracks | read | |
get_user_playlists | read | |
recommend_tracks | read | |
tidal_login | read |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (2 observation(s))
- Network
- declared (6 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (4)
"/usr/local/bin/uv", # macOS Homebrew
FLASK_APP_URL = f"http://127.0.0.1:{FLASK_PORT}"delete_tidal_playlist
assets/tidal_mcp_demo.gif
Gates applied: no_behavioural_pass.
2931adcd4082full audit observations/trust-audit/mcp-server/yuhuacheng__tidal.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 2931adcd4082 | CAUTION | B | 89 | first audit |
Questions
What tools does Tidal expose?
7 in total: 5 read-only, 1 that write, and 1 that can delete or overwrite (delete_tidal_playlist). Every one is listed on this page with its risk.
Is Tidal safe to connect to an agent?
With care. The audit graded it B (89/100) and found 4 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Tidal need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (2931adcd4082), read on 2026-10-08. The repository is watched and re-audited when it changes.