Check Spotify authentication status. Shows whether you are logged in and which account is connected. Call this first before using other tools.

Authenticate with Spotify using OAuth 2.0 with PKCE. Opens a browser window for you to authorize access. Requires SPOTIFY_CLIENT_ID environment variable. Only needed once — tokens are stored locally.

Log out of Spotify by clearing stored OAuth tokens. Use this to reset authentication or switch accounts.

Search for songs on Spotify. Returns track name, artists, album, duration, URI, and popularity.

Search for artists on Spotify. Returns artist name, genres, popularity, followers, and URI.

Search for albums on Spotify. Returns album name, artists, release date, track count, and URI.

Search for playlists on Spotify. Returns playlist name, owner, track count, and URI.

Get all playlists in your Spotify library (owned and followed). Returns playlist names, IDs, and URIs.

Create a new playlist in your Spotify account. Returns the new playlist ID and URI.

Add one or more tracks to a playlist. Use track URIs from search results (e.g., 'spotify:track:...').

Remove one or more tracks from a playlist by their Spotify track URIs.

Get the currently playing track including name, artists, progress, device, shuffle state, and repeat state.

Start or resume playback. Can play a specific track, album, artist, or playlist URI. If no URI provided, resumes current playback.

Pause playback on the active device or a specified device.

Skip to the next track in the queue.

Go back to the previous track. If more than 3 seconds in, restarts current track first.

Set the playback volume (0-100%). Requires a Spotify Premium account.

List all available Spotify Connect devices (phones, computers, speakers, etc.) with their IDs, names, types, and active status.

Transfer playback to a different Spotify Connect device. Use device IDs from get_devices.