Which integrations are available for this server?

Provides comprehensive access to [TIDAL](/mcp/servers/integrations/tidal) music streaming service, including search (tracks, albums, artists, playlists), favorites management, playlist operations (create, update, delete, add/remove tracks), album and artist information retrieval, and personalized recommendations through track and artist radio.

TIDAL MCP Server

A traditional MCP (Model Context Protocol) server for TIDAL music streaming service. Clean API wrapper following official MCP best practices - thin wrappers around tidalapi methods with no custom business logic.

Features

27 Tools

Category	Tool	Description
Auth	`login`	OAuth browser authentication
Search	`search_tracks`	Find tracks by name/artist
	`search_albums`	Find albums
	`search_artists`	Find artists
	`search_playlists`	Find public playlists
Favorites	`get_favorite_tracks`	Get liked tracks
	`get_favorite_albums`	Get saved albums
	`get_favorite_artists`	Get followed artists
	`add_track_to_favorites`	Like a track
	`remove_track_from_favorites`	Unlike a track
	`remove_album_from_favorites`	Remove saved album
Playlists	`get_user_playlists`	List your playlists
	`get_playlist_tracks`	Get tracks from playlist
	`create_playlist`	Create new playlist
	`add_tracks_to_playlist`	Add tracks to playlist
	`remove_tracks_from_playlist`	Remove tracks from playlist
	`update_playlist`	Update name/description
	`delete_playlist`	Delete a playlist
Albums	`get_album_tracks`	Get all album tracks
	`get_album`	Get album details
	`get_similar_albums`	Find similar albums
Artists	`get_artist`	Get artist details with bio
	`get_artist_albums`	Get artist discography
	`get_artist_top_tracks`	Get popular tracks
	`get_similar_artists`	Find similar artists
Recommendations	`get_track_radio`	Similar tracks to seed
	`get_artist_radio`	Tracks based on artist style

Installation

Requirements

Python 3.10+
uv (recommended) or pip

Setup

# Clone and enter directory cd tidal-mcp # Install with uv uv sync # Or with pip pip install -e .

Usage

With Claude Desktop

Add to your Claude Desktop config:

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

{ "mcpServers": { "tidal": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/tidal-mcp", "run", "tidal-mcp" ] } } }

Note: Use full path to uv (find with which uv)

With MCP Inspector

npx @modelcontextprotocol/inspector uv run tidal-mcp

Direct Usage

uv run tidal-mcp

Authentication

python authenticate.py

Example Workflows

Create a Playlist from Search Results

login - Authenticate with TIDAL
search_tracks("Radiohead Creep") - Find tracks
create_playlist("My Playlist", "A collection of favorites") - Create playlist
add_tracks_to_playlist(playlist_id, [track_ids...]) - Add tracks

Browse and Add Album to Playlist

search_albums("OK Computer") - Find album
get_album_tracks(album_id) - Get all tracks
add_tracks_to_playlist(playlist_id, [all_track_ids...]) - Add to playlist

Manage Existing Playlist

get_user_playlists() - List your playlists
get_playlist_tracks(playlist_id) - View tracks
remove_tracks_from_playlist(playlist_id, track_ids=[...]) - Remove tracks
update_playlist(playlist_id, name="New Name") - Rename

Development

Project Structure

tidal-mcp/ ├── pyproject.toml # Project configuration ├── README.md # This file ├── CLAUDE.md # AI development guidance └── src/ └── tidal_mcp/ ├── __init__.py # Package init ├── models.py # Pydantic response models └── server.py # MCP server with 27 tools

Dependencies

fastmcp>=2.12.0 - MCP protocol framework
tidalapi>=0.8.6 - TIDAL API client (v0.8.6+ required for working OAuth)
anyio>=4.0.0 - Async utilities

Testing

# Test with MCP Inspector npx @modelcontextprotocol/inspector uv run tidal-mcp # Quick protocol test echo '{"jsonrpc": "2.0", "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}, "id": 1}' | uv run tidal-mcp

Troubleshooting

Authentication Fails

Ensure tidalapi >= 0.8.6 (older versions have invalid OAuth credentials)
Delete .tidal-sessions/ and re-authenticate

Search Returns No Results

Simplify query (single artist or song name)
Check spelling

Port Conflicts (Inspector)

pkill -f "inspector|tidal-mcp"

Future Roadmap

The server currently has 27 tools covering core TIDAL functionality. Potential future additions:

Remote Server: HTTP/SSE transport for Claude.ai and mobile apps (see docs/REMOTE-DEPLOYMENT.md)
Advanced Search: ISRC/UPC lookup for precise track/album identification
Playback: Queue management and now-playing info (requires TIDAL Connect)
Social: Following users, collaborative playlists

License

MIT

Credits

Built with FastMCP and tidalapi.

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

TIDAL MCP Server

TIDAL MCP Server

Features

27 Tools

Installation

Requirements

Setup

Usage

With Claude Desktop

With MCP Inspector

Direct Usage

Authentication

Example Workflows

Create a Playlist from Search Results

Browse and Add Album to Playlist

Manage Existing Playlist

Development

Project Structure

Dependencies

Testing

Troubleshooting

Authentication Fails

Search Returns No Results

Port Conflicts (Inspector)

Future Roadmap

License

Credits

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API