TIDAL

You can run a TIDAL MCP server that builds personalized, context-aware music recommendations and manages playlists directly in your TIDAL account. By connecting your listening history with flexible prompts, this server finds similar tracks, applies your criteria (like year or mood), and creates or updates playlists in your account for quick, tailored listening.

How to use

You interact with the TIDAL MCP server through your MCP client. Start the server locally, then connect your client with the configured MCP endpoint. Once connected, you can ask for recommendations and playlist actions using natural language prompts. Examples include asking for tracks similar to your favorites but from recent years, or creating a playlist based on your top tracks with a specific vibe such as chill or late-night.

How to install

Prerequisites you need before installing are Python 3.10 or newer and a TIDAL subscription. You also require an MCP runner compatible with your environment.

Step by step commands to set up the server locally are as follows.

# 1) Clone the project repository
# (use the exact repository path you have access to)
git clone https://github.com/yuhuacheng/tidal-mcp.git
cd tidal-mcp

# 2) Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 3) Install the package in editable mode
uv pip install --editable .

Configuration and usage notes

{
  "mcpServers": {
    "TIDAL Integration": {
      "command": "/path/to/your/uv",
      "env": {
        "TIDAL_MCP_PORT": "5100"
      },
      "args": [
        "run",
        "--with",
        "requests",
        "--with",
        "mcp[cli]",
        "--with",
        "flask",
        "--with",
        "tidalapi",
        "mcp",
        "run",
        "/path/to/your/project/tidal-mcp/mcp_server/server.py"
      ]
    }
  }
}

This example shows how to start the MCP server in a local environment. The port can be customized with TIDAL_MCP_PORT, and the path to your server script should point to the actual location of your tidal-mcp project. Modify the paths to reflect your setup, then run the command to launch the MCP server.

## Available tools

### tidal\_login

Authenticate with TIDAL through a browser-based login flow to obtain access tokens for API calls.

### get\_favorite\_tracks

Fetch your favorite tracks from TIDAL to use as seed data for recommendations.

### recommend\_tracks

Request personalized track recommendations based on seeds and your preferences.

### create\_tidal\_playlist

Create a new playlist in your TIDAL account and populate it with recommended tracks.

### get\_user\_playlists

List all playlists in your TIDAL account to choose a target for modification.

### get\_playlist\_tracks

Retrieve all tracks from a specific playlist to analyze or reuse seeds.

### delete\_tidal\_playlist

Remove a playlist from your TIDAL account when you no longer need it.