This server enables personalized music management with your TIDAL account through AI-powered recommendations and playlist controls.
Key capabilities:
- Authenticate with your TIDAL account through browser login
- Retrieve and analyze your favorite tracks with customizable limits
- Get personalized music recommendations based on custom criteria (tempo, genre, release year) or seed tracks
- Manage playlists: create, view, delete, and add tracks
- View detailed information about tracks in specific playlists
- Configure integration with Claude Desktop for seamless LLM interaction
Uses Flask as the web framework for hosting the MCP server endpoints that communicate with Tidal's API.
Provides personalized music recommendations and playlist management for Tidal users, allowing for custom criteria filtering, creating playlists, viewing favorite tracks, and managing existing playlists directly in your Tidal account.
TIDAL MCP: My Custom Picks 🌟🎧
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:
- Create a virtual environment and install dependencies using uv:
- Install the package with all dependencies from the pyproject.toml file: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 specify the port by adding an optional env
section with the TIDAL_MCP_PORT
environment variable)
Example scrrenshot of the MCP configuration in Claude Desktop:
Steps to Install MCP Configuration
- Open Claude Desktop
- Go to Settings > Developer
- Click on "Edit Config"
- Paste the modified JSON configuration
- Save the configuration
- Restart Claude Desktop
Suggested Prompt Starters
Once configured, you can interact with your TIDAL account through a LLM by asking questions like:
- “Recommend songs like those in this playlist, but slower and more acoustic.”
- “Create a playlist based on my top tracks, but focused on chill, late-night vibes.”
- “Find songs like these in playlist XYZ but in languages other than English.”
💡 You can also ask the model to:
- Use more tracks as seeds to broaden the inspiration.
- Return more recommendations if you want a longer playlist.
- Or delete a playlist if you’re not into it — no pressure!
Available Tools
The TIDAL MCP integration provides the following tools:
tidal_login
: Authenticate with TIDAL through browser login flowget_favorite_tracks
: Retrieve your favorite tracks from TIDALrecommend_tracks
: Get personalized music recommendationscreate_tidal_playlist
: Create a new playlist in your TIDAL accountget_user_playlists
: List all your playlists on TIDALget_playlist_tracks
: Retrieve all tracks from a specific playlistdelete_tidal_playlist
: Delete a playlist from your TIDAL account
License
Acknowledgements
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that enables highly personalized music recommendations from TIDAL based on custom criteria, allowing users to create and manage playlists directly in their TIDAL account.
- Features
- Quick Start
- MCP Client Configuration
- Suggested Prompt Starters
- Available Tools
- License
- Acknowledgements
Related Resources
Related MCP Servers
- -securityAlicense-qualityThis MCP server provides access to TripAdvisor data for planning vacations, enabling users to search for and get details about locations, attractions, restaurants, and hotels through an interactive planning experience.Last updated -1PythonApache 2.0
- -security-license-qualityAn MCP server template that likely enables interaction with Spotify's API, allowing users to perform Spotify-related operations through natural language commands.Last updated -TypeScript
- -securityFlicense-qualityAn MCP server that enhances TickTick workflow by providing comprehensive task management tools with improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with TickTick tasks with greater precision.Last updated -24Python
- AsecurityAlicenseAqualityA server that lets you get customized music recommendations from TIDAL based on your specific criteria, allowing you to create new playlists directly in your TIDAL account.Last updated -715PythonMIT License