🎵 TIDAL MCP (Community Maintained Fork)

📢 Active Maintenance Notice: This is an actively maintained community fork of yuhuacheng/tidal-mcp. The original repository appears unmaintained since May 2025. Contributions, issues, and PRs are welcome here!

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.

🆕 What's New in This Fork

This community fork includes significant improvements over the original:

• ✅ Docker Support: Full Docker and docker-compose setup for easy deployment
• ✅ Search Functionality: Search for tracks, albums, artists, and playlists across TIDAL
• ✅ Pagination: Fetch all tracks from large playlists (no more 50-track limit!)
• ✅ Complete Playlist Editing: Add, remove, reorder tracks, and update metadata
• ✅ Refactored Codebase: ~60% smaller files with better organization and maintainability
• ✅ DRY Pagination Helper: Reusable pagination utilities across all endpoints

See the full changelog and contribute at: https://github.com/ibeal/tidal-mcp

Features

• 🌟 Music Recommendations: Get personalized track recommendations based on your listening history plus your custom criteria
• 🎵 Full Playlist Management: Create, view, edit, and delete playlists with complete control
• 🔍 Advanced Search: Search across tracks, albums, artists, and playlists
• 📄 Smart Pagination: Automatically fetch all tracks from playlists of any size
• 🎛️ Playlist Editing: Add, remove, reorder tracks, and update metadata
• 🐳 Docker Ready: Easy deployment with Docker and docker-compose support
• 🔐 OAuth Authentication: Secure browser-based TIDAL login flow

Quick Start

Prerequisites

• Python 3.10+ OR Docker
• uv (Python package manager) - only needed for non-Docker installation
• TIDAL subscription

Installation

Option 1: Docker (Recommended)

1. Clone this repository:

   git clone https://github.com/ibeal/tidal-mcp.git
   cd tidal-mcp
   

2. Build and run with Docker Compose:

   docker-compose up -d
   

   Or with Docker directly:

   docker build -t tidal-mcp .
   docker run -d -p 5050:5050 --name tidal-mcp tidal-mcp
   

   The server will be available at http://localhost:5050.

3. To customize the port, edit the TIDAL_MCP_PORT environment variable in docker-compose.yml or pass it to docker run:

   docker run -d -p 5100:5100 -e TIDAL_MCP_PORT=5100 --name tidal-mcp tidal-mcp
   

Option 2: Local Python Installation

1. Clone this repository:

   git clone https://github.com/ibeal/tidal-mcp.git
   cd tidal-mcp
   

2. Create a virtual environment and install dependencies using uv:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install the package with all dependen

... View full README on GitHub