Spotify

Get details for a Spotify album by ID. Returns album name, artists, tracks, release date, genres, and more.

List tracks in a Spotify album with pagination. Use offset from page_info to fetch next page.

Get details for a Spotify artist by ID. Returns name, genres, popularity, followers, and images.

List albums by a Spotify artist with pagination. Filter by include_groups (album, single, appears_on, compilation).

Get details for a Spotify audiobook by ID. Returns name, authors, narrators, publisher, chapters, and more.

List chapters of a Spotify audiobook with pagination. Use offset from page_info for next page.

Get details for a Spotify audiobook chapter by ID. Returns name, description, duration, chapter number, and more.

Get details for a Spotify episode by ID. Returns name, description, duration, release date, show info, and more.

Follow artists or users on Spotify. Provide type (‘artist’ or ‘user’) and list of Spotify IDs.

Unfollow artists or users on Spotify. Provide type (‘artist’ or ‘user’) and list of Spotify IDs.

List artists the user follows. Cursor-based pagination: use ‘after’ from page_info.cursor for next page.

List the current user’s saved tracks with pagination. Use offset from page_info for next page.

List the current user’s saved albums with pagination. Use offset from page_info for next page.

List the current user’s saved shows/podcasts with pagination. Use offset from page_info for next page.

List the current user’s saved episodes with pagination. Use offset from page_info for next page.

List the current user’s saved audiobooks with pagination. Use offset from page_info for next page.

Save tracks, albums, shows, episodes, or audiobooks to the user’s library. Provide type and list of IDs (max 50).

Remove tracks, albums, shows, episodes, or audiobooks from the user’s library. Provide type and list of IDs.

Check if tracks, albums, shows, episodes, or audiobooks are saved in the user’s library. Returns {id, is_saved} for each.

Get the current playback state including device, repeat/shuffle mode, playing item, and progress.

Get the user’s available Spotify devices. Returns device ID, name, type, volume, and active status.

Get the currently playing track or episode. Returns None if nothing is playing.

Get the user’s playback queue. Returns the currently playing item and upcoming items in the queue.

Start or resume playback. Requires Spotify Premium. Provide context_uri (album/playlist) or uris (track list). Use get_devices to find device_id.

Pause playback on the active device. Requires Spotify Premium. Use get_devices to find device_id.

Skip to the next track. Requires Spotify Premium.

Skip to the previous track. Requires Spotify Premium.

Seek to a position in the current track. Requires Spotify Premium. Position is in milliseconds.

Set repeat mode: ‘track’ (repeat current), ‘context’ (repeat album/playlist), or ‘off’. Requires Premium.

Enable or disable shuffle mode. Requires Spotify Premium.

Set playback volume (0-100). Requires Spotify Premium. Not available on all devices.

Add a track or episode to the playback queue. Requires Premium. URI format: spotify:track:ID or spotify:episode:ID.

Transfer playback to another device. Requires Premium. Use get_devices to find device IDs. Pass single device_id in list.

Get details for a Spotify playlist by ID. Returns name, description, owner, tracks, and images.

List the current user’s playlists with pagination. Use offset from page_info for next page.

Create a new playlist for the current user. Returns the created playlist with ID and URI.

Update a playlist’s name, description, or visibility. Use get_playlist to verify changes.

List items (tracks/episodes) in a playlist with pagination. Use offset from page_info for next page.

Add tracks/episodes to a playlist. Provide URIs in spotify:track:ID or spotify:episode:ID format. Returns snapshot_id.

Remove tracks/episodes from a playlist by URI. Provide URIs in spotify:track:ID format. Returns snapshot_id.

Reorder items in a playlist. Move range_length items starting at range_start to insert_before position.

Search Spotify for tracks, albums, artists, playlists, shows, episodes, or audiobooks. Specify types as comma-separated string. Supports field filters like artist:name, album:name.

Get details for a Spotify show/podcast by ID. Returns name, description, publisher, total episodes, and more.

List episodes of a Spotify show/podcast with pagination. Use offset from page_info for next page.

Get details for a Spotify track by ID. Returns track name, artists, album, duration, popularity, and more.

Get the current user’s Spotify profile. Returns display name, email, country, subscription level, and more.

Get the user’s top artists or tracks based on listening history. Supports time ranges: short_term (~4 weeks), medium_term (~6 months), long_term (all time).

Get the user’s recently played tracks. Cursor-based: use ‘after’ timestamp from page_info.cursor for next page.

Validate Spotify OAuth2 credentials by fetching the current user profile. Returns {success, message}.