Tidal Mcp

ibeal/tidal-mcp

Connects Claude to TIDAL's music streaming service through their API. Exposes search across tracks, albums, artists, and playlists, plus full playlist management including creation, editing, reordering, and deletion. The main workflow centers on recommendations: you can ask for tracks similar to your recent favorites but filtered by criteria like release year, tempo, or mood, and the LLM uses TIDAL's similarity API to build custom playlists directly in your account. This is a community fork that adds Docker support, pagination for large playlists, and search functionality missing from the original. Authentication happens via OAuth with a browser flow, and sessions persist across restarts. Useful when you want programmatic music curation that goes beyond platform defaults.

GitHub stars: 6
tools: 40
transport: STDIO
env var: 1
last updated: Jun 25, 2026

View on GitHub

Tools

40 tools

Public tool metadata for what this MCP can expose to an agent.

tidal_searchSearch Tidal for artists, albums, tracks, videos, or playlists2 params

Search Tidal for artists, albums, tracks, videos, or playlists

Parameters* required

querystring

Search query

typestring

Type of content to searchone of artist · album · track · video · playlist

tidal_search_suggestionsGet search suggestions and direct hits for a query1 params

Get search suggestions and direct hits for a query

Parameters* required

querystring

Search query

tidal_artist_infoGet artist details including biography1 params

Get artist details including biography

Parameters* required

artistIdstring

Tidal artist ID

tidal_artist_tracksGet top tracks for an artist1 params

Get top tracks for an artist

Parameters* required

artistIdstring

Tidal artist ID

tidal_artist_albumsGet albums by an artist1 params

Get albums by an artist

Parameters* required

artistIdstring

Tidal artist ID

tidal_similar_artistsFind artists similar to a given artist1 params

Find artists similar to a given artist

Parameters* required

artistIdstring

Tidal artist ID

tidal_artist_radioGet radio playlists based on an artist1 params

Get radio playlists based on an artist

Parameters* required

artistIdstring

Tidal artist ID

tidal_track_infoGet track details including artists, album, BPM, key1 params

Get track details including artists, album, BPM, key

Parameters* required

trackIdstring

Tidal track ID

tidal_track_radioGet radio playlists based on a track1 params

Get radio playlists based on a track

Parameters* required

trackIdstring

Tidal track ID

tidal_track_by_isrcFind tracks by ISRC code1 params

Find tracks by ISRC code

Parameters* required

isrcstring

ISRC code (e.g., USRC11700101)

tidal_similar_tracksFind tracks similar to a given track1 params

Find tracks similar to a given track

Parameters* required

trackIdstring

Tidal track ID

tidal_album_infoGet album details including artists and cover art1 params

Get album details including artists and cover art

Parameters* required

albumIdstring

Tidal album ID

tidal_album_by_barcodeFind albums by barcode/UPC1 params

Find albums by barcode/UPC

Parameters* required

barcodestring

Album barcode (UPC/EAN)

tidal_playlist_listList your playlists

List your playlists

No parameter schema in public metadata yet.

tidal_playlist_createCreate a new playlist2 params

Create a new playlist

Parameters* required

descriptionstring

Playlist descriptiondefault:

namestring

Playlist name

tidal_playlist_renameRename a playlist2 params

Rename a playlist

Parameters* required

namestring

New name

playlistIdstring

Playlist ID

tidal_playlist_deleteDelete a playlist1 params

Delete a playlist

Parameters* required

playlistIdstring

Playlist ID

tidal_playlist_add_trackAdd a track to a playlist2 params

Add a track to a playlist

Parameters* required

playlistIdstring

Playlist ID

trackIdstring

Track ID

tidal_playlist_remove_trackRemove a track from a playlist2 params

Remove a track from a playlist

Parameters* required

playlistIdstring

Playlist ID

trackIdstring

Track ID

tidal_playlist_add_albumAdd all tracks from an album to a playlist2 params

Add all tracks from an album to a playlist

Parameters* required

albumIdstring

Album ID

playlistIdstring

Playlist ID

tidal_playlist_move_trackMove a track to a different position in a playlist3 params

Move a track to a different position in a playlist

Parameters* required

playlistIdstring

Playlist ID

positionBeforestring

Item ID to place before, or "end"default: end

trackIdstring

Track ID

tidal_playlist_update_descriptionUpdate playlist description2 params

Update playlist description

Parameters* required

descriptionstring

New description

playlistIdstring

Playlist ID

tidal_library_addAdd an item to your library/favorites2 params

Add an item to your library/favorites

Parameters* required

resourceIdstring

Item ID

resourceTypestring

Type of itemone of artist · album · track · video

tidal_library_removeRemove an item from your library/favorites2 params

Remove an item from your library/favorites

Parameters* required

resourceIdstring

Item ID

resourceTypestring

Type of itemone of artist · album · track · video

tidal_library_favorited_playlistsList your favorited playlists

List your favorited playlists

No parameter schema in public metadata yet.

tidal_library_add_playlist_favoriteAdd a playlist to favorites1 params

Add a playlist to favorites

Parameters* required

playlistIdstring

Playlist ID

tidal_library_remove_playlist_favoriteRemove a playlist from favorites1 params

Remove a playlist from favorites

Parameters* required

playlistIdstring

Playlist ID

tidal_playback_infoGet playback/streaming info for a track2 params

Get playback/streaming info for a track

Parameters* required

qualitystring

Audio qualityone of LOW · HIGH · LOSSLESS · HI_RESdefault: HIGH

trackIdstring

Track ID

tidal_playback_urlGet stream URL for a track2 params

Get stream URL for a track

Parameters* required

qualitystring

Audio qualityone of LOW · HIGH · LOSSLESS · HI_RESdefault: HIGH

trackIdstring

Track ID

tidal_recommendationsGet personalized music recommendations across daily, discovery, new-release, and offline mixes1 params

Get personalized music recommendations across daily, discovery, new-release, and offline mixes

Parameters* required

categorystring

Filter to a single mix categoryone of daily · discovery · new-release · offline

tidal_mix_itemsGet items inside a specific mix returned by tidal_recommendations2 params

Get items inside a specific mix returned by tidal_recommendations

Parameters* required

categorystring

Mix categoryone of daily · discovery · new-release · offline

mixIdstring

Mix ID from tidal_recommendations

tidal_search_historyList your recent search queries

List your recent search queries

No parameter schema in public metadata yet.

tidal_search_history_deleteDelete a single search history entry1 params

Delete a single search history entry

Parameters* required

entryIdstring

Search history entry ID

tidal_search_history_clearClear all search history entries

Clear all search history entries

No parameter schema in public metadata yet.

tidal_saved_listList items saved for later (separate from main library)

List items saved for later (separate from main library)

No parameter schema in public metadata yet.

tidal_saved_addSave an item for later without adding it to the main library2 params

Save an item for later without adding it to the main library

Parameters* required

itemIdstring

Item ID

itemTypestring

Item typeone of tracks · albums · artists · playlists · videos

tidal_saved_removeRemove an item from the save-for-later list2 params

Remove an item from the save-for-later list

Parameters* required

itemIdstring

Item ID

itemTypestring

Item typeone of tracks · albums · artists · playlists · videos

tidal_share_createCreate a public share link for a track or album2 params

Create a public share link for a track or album

Parameters* required

resourceIdstring

Resource ID

resourceTypestring

Type of resource to shareone of tracks · albums

tidal_recently_addedGet recently added items from your library1 params

Get recently added items from your library

Parameters* required

typestring

Type of itemsone of tracks · albums · artists

tidal_user_profileGet your Tidal user profile

Get your Tidal user profile

No parameter schema in public metadata yet.

Configuration

TIDAL_MCP_PORT

Port for the TIDAL API Flask server (default: 5050)

Readme

🎵 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!

Demo: Music Recommendations in Action

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:

View the full README on GitHub

Details

Repository: github.com/ibeal/tidal-mcp
Category: Search & Web Crawling
Package: ghcr.io/ibeal/tidal-mcp:latest
Transport: STDIO
Registry: MCP registry, active

Related Search & Web Crawling MCP servers

View all

Frankfurterlineofflight/frankfurter-mcpConvert currencies and fetch blended FX rates from 50+ institutional sources.6stars

Fedlex Connectorjaytheskier/fedlex-connectorSearch Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.6stars

RAGMapkhalidsaidi/ragmapFind a retrieval MCP server that works today: a daily-checked list of servers that search knowledge.6stars

Pilotmcpmahach666/pilotmcpMCP server for ASCON Pilot-ICE PDM: objects, documents, remarks, search, admin6stars

Jitapink3750/jitapiTurn any OpenAPI spec into an executable agent interface using graphs and semantic search.6stars

Parecodebasilskywalk/parecodeToken-aware ripgrep code search and atomic multi-file edits for coding agents.5stars