# TIDAL MCP

Connect an AI agent to a TIDAL account to search music, inspect playlists, and manage a collection. Account changes require explicit approval.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: sickn33
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sickn33/tidal-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/tidal-mcp

## What it does

TIDAL MCP gives an agent tools for finding tracks, albums, artists, and lyrics, exploring recommendations, and working with favorites, playlists, and folders. It can analyze or compare playlists and export them as JSON or M3U. The server registers 122 tools with defined input and output schemas.

Connect it with `npx -y @sickn33/tidal-mcp` and authorize a TIDAL account before use. It runs on macOS or Linux and requires Node.js 18 or later, Python 3.11–3.13, and `uv`.

Account writes start disabled. Setting `TIDAL_MCP_ENABLE_WRITES` enables the write flow, but does not bypass review: the agent prepares a preview, gets explicit approval, then applies the recorded action. Without that flag, remote account changes are unavailable.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TIDAL_MCP_ENABLE_WRITES`, `TIDAL_MCP_DATA_DIR`, `TIDAL_MCP_EXPORT_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env TIDAL_MCP_ENABLE_WRITES=<TIDAL_MCP_ENABLE_WRITES> --env TIDAL_MCP_DATA_DIR=<TIDAL_MCP_DATA_DIR> --env TIDAL_MCP_EXPORT_DIR=<TIDAL_MCP_EXPORT_DIR> --transport stdio tidal-mcp -- npx -y @sickn33/tidal-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tidal-mcp --env TIDAL_MCP_ENABLE_WRITES=<TIDAL_MCP_ENABLE_WRITES> --env TIDAL_MCP_DATA_DIR=<TIDAL_MCP_DATA_DIR> --env TIDAL_MCP_EXPORT_DIR=<TIDAL_MCP_EXPORT_DIR> -- npx -y @sickn33/tidal-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tidal-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@sickn33/tidal-mcp"
            ],
            "env": {
                "TIDAL_MCP_ENABLE_WRITES": "<TIDAL_MCP_ENABLE_WRITES>",
                "TIDAL_MCP_DATA_DIR": "<TIDAL_MCP_DATA_DIR>",
                "TIDAL_MCP_EXPORT_DIR": "<TIDAL_MCP_EXPORT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tidal-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@sickn33/tidal-mcp"
            ],
            "env": {
                "TIDAL_MCP_ENABLE_WRITES": "<TIDAL_MCP_ENABLE_WRITES>",
                "TIDAL_MCP_DATA_DIR": "<TIDAL_MCP_DATA_DIR>",
                "TIDAL_MCP_EXPORT_DIR": "<TIDAL_MCP_EXPORT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TIDAL_MCP_ENABLE_WRITES=<TIDAL_MCP_ENABLE_WRITES> -e TIDAL_MCP_DATA_DIR=<TIDAL_MCP_DATA_DIR> -e TIDAL_MCP_EXPORT_DIR=<TIDAL_MCP_EXPORT_DIR> tidal-mcp npx -y @sickn33/tidal-mcp
```
Replace <…> with your own values

## When to use it
- search TIDAL for tracks, albums, and artists
- inspect a playlist and compare it with another
- find music related to selected tracks
- export a playlist as JSON or M3U
- review a proposed playlist change before applying it

## Example prompts
- Find this artist’s albums in TIDAL and compare them.
- Analyze my playlist, find duplicates, and describe its track order.
- Prepare a playlist change and show me the preview before applying it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md