TIDAL Server

Model Context Protocol (MCP) server for TIDAL Music. Enables AI assistants (Claude, etc.) to access TIDAL catalog: search, playlists, favorites, and recommendations.

Note: Uses tidalapi which accesses TIDAL's internal APIs (reverse-engineered).

Installation

git clone https://github.com/yourusername/mcp-tidal.git
cd mcp-tidal
pip install -e .

Configuration

1. Authentication

First time, authenticate with your TIDAL account:

python3 -c "from mcp_tidal.client import TidalClient; TidalClient().login()"

Session saved to /tmp/tidal-session-oauth.json.

2. Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tidal": {
      "command": "mcp-tidal"
    }
  }
}

Available Tools

Authentication

• tidal_login() - Browser authentication
• check_auth() - Check status

Search & Metadata

• search_music(query, limit) - Search all content
• get_track(track_id) - Track details
• get_album(album_id) - Album details
• get_artist(artist_id) - Artist details

Favorites & Recommendations

• get_favorite_tracks(limit) - Your favorite tracks
• get_track_recommendations(track_id, limit) - Suggestions

Playlists

• get_user_playlists() - Your playlists
• get_playlist_tracks(playlist_id, limit) - Playlist tracks
• create_playlist(title, description, track_ids) - Create playlist
• add_tracks_to_playlist(playlist_id, track_ids) - Add tracks to playlist
• remove_tracks_from_playlist(playlist_id, track_indices) - Remove tracks from playlist
• delete_playlist(playlist_id) - Delete playlist

Transport Modes

stdio (default - for Claude Desktop)

mcp-tidal

SSE (Server-Sent Events)

mcp-tidal-sse  # Runs on http://0.0.0.0:8000/sse

HTTP Streamable

mcp-tidal-http  # Runs on http://127.0.0.1:8000/mcp