Spotify
Search music, manage playlists, control playback, and access your library
Configuration
Search
Operation
Search
Spotify Account*
Connect spotify...
Search Query*
e.g., "Bohemian Rhapsody", "artist:Queen"
Search Type
Tracks
Limit
Number of results (1-50, default: 20)
Search (
spotify_search)Search for tracks, albums, artists, or playlists on Spotify. Returns matching results based on the query.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query (e.g., "Bohemian Rhapsody", "artist:Queen", "genre:rock") |
type | string | No | Type of results: track, album, artist, playlist, or comma-separated (e.g., "track,artist") |
limit | number | No | Maximum number of results to return (1-50) |
offset | number | No | Index of the first result to return for pagination |
market | string | No | ISO 3166-1 alpha-2 country code to filter results (e.g., "US", "GB") |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | List of matching tracks |
artists | array | List of matching artists |
albums | array | List of matching albums |
playlists | array | List of matching playlists |
Get Track
Operation
Get Track
Spotify Account*
Connect spotify...
Track ID*
Spotify track ID
Get Track (
spotify_get_track)Get detailed information about a specific track on Spotify by its ID.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
trackId | string | Yes | The Spotify ID of the track |
market | string | No | ISO 3166-1 alpha-2 country code for track availability |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify track ID |
name | string | Track name |
artists | array | List of artists |
album | object | Album information |
duration_ms | number | Track duration in milliseconds |
explicit | boolean | Whether the track has explicit content |
popularity | number | Popularity score (0-100) |
preview_url | string | URL to 30-second preview |
external_url | string | Spotify URL |
uri | string | Spotify URI for the track |
Get Multiple Tracks
Operation
Get Multiple Tracks
Spotify Account*
Connect spotify...
Track IDs*
Comma-separated track IDs
Get Multiple Tracks (
spotify_get_tracks)Get detailed information about multiple tracks on Spotify by their IDs (up to 50).
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
trackIds | string | Yes | Comma-separated list of Spotify track IDs (max 50) |
market | string | No | ISO 3166-1 alpha-2 country code for track availability |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | List of tracks |
Get Album
Operation
Get Album
Spotify Account*
Connect spotify...
Album ID*
Spotify album ID
Get Album (
spotify_get_album)Get detailed information about an album on Spotify by its ID, including track listing.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumId | string | Yes | The Spotify ID of the album |
market | string | No | ISO 3166-1 alpha-2 country code for track availability |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify album ID |
name | string | Album name |
artists | array | List of artists |
album_type | string | Type of album (album, single, compilation) |
total_tracks | number | Total number of tracks |
release_date | string | Release date |
label | string | Record label |
popularity | number | Popularity score (0-100) |
genres | array | List of genres |
image_url | string | Album cover image URL |
tracks | array | List of tracks on the album |
external_url | string | Spotify URL |
Get Multiple Albums
Operation
Get Multiple Albums
Spotify Account*
Connect spotify...
Album IDs*
Comma-separated album IDs
Get Multiple Albums (
spotify_get_albums)Get details for multiple albums by their IDs.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumIds | string | Yes | Comma-separated album IDs (max 20) |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
albums | json | List of albums |
Get Album Tracks
Operation
Get Album Tracks
Spotify Account*
Connect spotify...
Album ID*
Spotify album ID
Limit
Number of results (1-50, default: 20)
Get Album Tracks (
spotify_get_album_tracks)Get the tracks from an album.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumId | string | Yes | The Spotify album ID |
limit | number | No | Number of tracks to return (1-50) |
offset | number | No | Index of first track to return |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | json | List of tracks |
total | number | Total number of tracks |
next | string | URL for next page |
Get Saved Albums
Operation
Get Saved Albums
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Saved Albums (
spotify_get_saved_albums)Get the user's saved albums.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of albums to return (1-50) |
offset | number | No | Index of first album to return |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
albums | json | List of saved albums |
total | number | Total saved albums |
next | string | URL for next page |
Save Albums
Operation
Save Albums
Spotify Account*
Connect spotify...
Album IDs*
Comma-separated album IDs
Save Albums (
spotify_save_albums)Save albums to the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumIds | string | Yes | Comma-separated album IDs (max 20) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether albums were saved |
Remove Saved Albums
Operation
Remove Saved Albums
Spotify Account*
Connect spotify...
Album IDs*
Comma-separated album IDs
Remove Saved Albums (
spotify_remove_saved_albums)Remove albums from the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumIds | string | Yes | Comma-separated album IDs (max 20) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether albums were removed |
Check Saved Albums
Operation
Check Saved Albums
Spotify Account*
Connect spotify...
Album IDs*
Comma-separated album IDs
Check Saved Albums (
spotify_check_saved_albums)Check if albums are saved in library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
albumIds | string | Yes | Comma-separated album IDs (max 20) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each album |
Get Artist
Operation
Get Artist
Spotify Account*
Connect spotify...
Artist ID*
Spotify artist ID
Get Artist (
spotify_get_artist)Get detailed information about an artist on Spotify by their ID.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | Yes | The Spotify ID of the artist |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify artist ID |
name | string | Artist name |
genres | array | List of genres associated with the artist |
popularity | number | Popularity score (0-100) |
followers | number | Number of followers |
image_url | string | Artist image URL |
external_url | string | Spotify URL |
Get Multiple Artists
Operation
Get Multiple Artists
Spotify Account*
Connect spotify...
Artist IDs*
Comma-separated artist IDs
Get Multiple Artists (
spotify_get_artists)Get details for multiple artists by their IDs.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistIds | string | Yes | Comma-separated artist IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
artists | json | List of artists |
Get Artist Albums
Operation
Get Artist Albums
Spotify Account*
Connect spotify...
Artist ID*
Spotify artist ID
Limit
Number of results (1-50, default: 20)
Get Artist Albums (
spotify_get_artist_albums)Get albums by an artist on Spotify. Can filter by album type.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | Yes | The Spotify ID of the artist |
include_groups | string | No | Filter by album type: album, single, appears_on, compilation (comma-separated) |
limit | number | No | Maximum number of albums to return (1-50) |
offset | number | No | Index of the first album to return |
market | string | No | ISO 3166-1 alpha-2 country code |
Output
| Parameter | Type | Description |
|---|---|---|
albums | array | Artist's albums |
total | number | Total number of albums available |
next | string | URL for next page of results |
Get Artist Top Tracks
Operation
Get Artist Top Tracks
Spotify Account*
Connect spotify...
Artist ID*
Spotify artist ID
Get Artist Top Tracks (
spotify_get_artist_top_tracks)Get the top 10 most popular tracks by an artist on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistId | string | Yes | The Spotify ID of the artist |
market | string | No | ISO 3166-1 alpha-2 country code (required for this endpoint) |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | Artist's top tracks |
Follow Artists
Operation
Follow Artists
Spotify Account*
Connect spotify...
Artist IDs*
Comma-separated artist IDs
Follow Artists (
spotify_follow_artists)Follow one or more artists.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistIds | string | Yes | Comma-separated artist IDs to follow (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether artists were followed successfully |
Unfollow Artists
Operation
Unfollow Artists
Spotify Account*
Connect spotify...
Artist IDs*
Comma-separated artist IDs
Unfollow Artists (
spotify_unfollow_artists)Unfollow one or more artists.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
artistIds | string | Yes | Comma-separated artist IDs to unfollow (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether artists were unfollowed successfully |
Get Followed Artists
Operation
Get Followed Artists
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Followed Artists (
spotify_get_followed_artists)Get the user's followed artists.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of artists to return (1-50) |
after | string | No | Cursor for pagination (last artist ID from previous request) |
Output
| Parameter | Type | Description |
|---|---|---|
artists | json | List of followed artists |
total | number | Total number of followed artists |
next | string | Cursor for next page |
Check Following
Operation
Check Following
Spotify Account*
Connect spotify...
Type
Artist
IDs to Check*
Comma-separated artist or user IDs
Check Following (
spotify_check_following)Check if the user follows artists or users.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Type to check: "artist" or "user" |
ids | string | Yes | Comma-separated artist or user IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each ID |
Get Show
Operation
Get Show
Spotify Account*
Connect spotify...
Show ID*
Spotify show/podcast ID
Get Show (
spotify_get_show)Get details for a podcast show.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showId | string | Yes | The Spotify show ID |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Show ID |
name | string | Show name |
description | string | Show description |
publisher | string | Publisher name |
total_episodes | number | Total episodes |
explicit | boolean | Contains explicit content |
languages | json | Languages |
image_url | string | Cover image URL |
external_url | string | Spotify URL |
Get Multiple Shows
Operation
Get Multiple Shows
Spotify Account*
Connect spotify...
Show IDs*
Comma-separated show IDs
Get Multiple Shows (
spotify_get_shows)Get details for multiple podcast shows.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | Comma-separated show IDs (max 50) |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
shows | json | List of shows |
Get Show Episodes
Operation
Get Show Episodes
Spotify Account*
Connect spotify...
Show ID*
Spotify show/podcast ID
Limit
Number of results (1-50, default: 20)
Get Show Episodes (
spotify_get_show_episodes)Get episodes from a podcast show.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showId | string | Yes | The Spotify show ID |
limit | number | No | Number of episodes to return (1-50) |
offset | number | No | Index of first episode to return |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
episodes | json | List of episodes |
total | number | Total episodes |
next | string | URL for next page |
Get Saved Shows
Operation
Get Saved Shows
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Saved Shows (
spotify_get_saved_shows)Get the user's saved podcast shows.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of shows to return (1-50) |
offset | number | No | Index of first show to return |
Output
| Parameter | Type | Description |
|---|---|---|
shows | json | List of saved shows |
total | number | Total saved shows |
next | string | URL for next page |
Save Shows
Operation
Save Shows
Spotify Account*
Connect spotify...
Show IDs*
Comma-separated show IDs
Save Shows (
spotify_save_shows)Save podcast shows to the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | Comma-separated show IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether shows were saved |
Remove Saved Shows
Operation
Remove Saved Shows
Spotify Account*
Connect spotify...
Show IDs*
Comma-separated show IDs
Remove Saved Shows (
spotify_remove_saved_shows)Remove podcast shows from the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | Comma-separated show IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether shows were removed |
Check Saved Shows
Operation
Check Saved Shows
Spotify Account*
Connect spotify...
Show IDs*
Comma-separated show IDs
Check Saved Shows (
spotify_check_saved_shows)Check if shows are saved in library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
showIds | string | Yes | Comma-separated show IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each show |
Get Episode
Operation
Get Episode
Spotify Account*
Connect spotify...
Episode ID*
Spotify episode ID
Get Episode (
spotify_get_episode)Get details for a podcast episode.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
episodeId | string | Yes | The Spotify episode ID |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Episode ID |
name | string | Episode name |
description | string | Episode description |
duration_ms | number | Duration in ms |
release_date | string | Release date |
explicit | boolean | Contains explicit content |
show | json | Parent show info |
image_url | string | Cover image URL |
external_url | string | Spotify URL |
Get Multiple Episodes
Operation
Get Multiple Episodes
Spotify Account*
Connect spotify...
Episode IDs*
Comma-separated episode IDs
Get Multiple Episodes (
spotify_get_episodes)Get details for multiple podcast episodes.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
episodeIds | string | Yes | Comma-separated episode IDs (max 50) |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
episodes | json | List of episodes |
Get Saved Episodes
Operation
Get Saved Episodes
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Saved Episodes (
spotify_get_saved_episodes)Get the user's saved podcast episodes.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of episodes to return (1-50) |
offset | number | No | Index of first episode to return |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
episodes | json | List of saved episodes |
total | number | Total saved episodes |
next | string | URL for next page |
Save Episodes
Operation
Save Episodes
Spotify Account*
Connect spotify...
Episode IDs*
Comma-separated episode IDs
Save Episodes (
spotify_save_episodes)Save podcast episodes to the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
episodeIds | string | Yes | Comma-separated episode IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether episodes were saved |
Remove Saved Episodes
Operation
Remove Saved Episodes
Spotify Account*
Connect spotify...
Episode IDs*
Comma-separated episode IDs
Remove Saved Episodes (
spotify_remove_saved_episodes)Remove podcast episodes from the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
episodeIds | string | Yes | Comma-separated episode IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether episodes were removed |
Check Saved Episodes
Operation
Check Saved Episodes
Spotify Account*
Connect spotify...
Episode IDs*
Comma-separated episode IDs
Check Saved Episodes (
spotify_check_saved_episodes)Check if episodes are saved in library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
episodeIds | string | Yes | Comma-separated episode IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each episode |
Get Audiobook
Operation
Get Audiobook
Spotify Account*
Connect spotify...
Audiobook ID*
Spotify audiobook ID
Get Audiobook (
spotify_get_audiobook)Get details for an audiobook.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookId | string | Yes | The Spotify audiobook ID |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Audiobook ID |
name | string | Audiobook name |
authors | json | Authors |
narrators | json | Narrators |
publisher | string | Publisher |
description | string | Description |
total_chapters | number | Total chapters |
languages | json | Languages |
image_url | string | Cover image URL |
external_url | string | Spotify URL |
Get Multiple Audiobooks
Operation
Get Multiple Audiobooks
Spotify Account*
Connect spotify...
Audiobook IDs*
Comma-separated audiobook IDs
Get Multiple Audiobooks (
spotify_get_audiobooks)Get details for multiple audiobooks.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookIds | string | Yes | Comma-separated audiobook IDs (max 50) |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
audiobooks | json | List of audiobooks |
Get Audiobook Chapters
Operation
Get Audiobook Chapters
Spotify Account*
Connect spotify...
Audiobook ID*
Spotify audiobook ID
Limit
Number of results (1-50, default: 20)
Get Audiobook Chapters (
spotify_get_audiobook_chapters)Get chapters from an audiobook.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookId | string | Yes | The Spotify audiobook ID |
limit | number | No | Number of chapters to return (1-50) |
offset | number | No | Index of first chapter to return |
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
chapters | json | List of chapters |
total | number | Total chapters |
next | string | URL for next page |
Get Saved Audiobooks
Operation
Get Saved Audiobooks
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Saved Audiobooks (
spotify_get_saved_audiobooks)Get the user's saved audiobooks.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of audiobooks to return (1-50) |
offset | number | No | Index of first audiobook to return |
Output
| Parameter | Type | Description |
|---|---|---|
audiobooks | json | List of saved audiobooks |
total | number | Total saved audiobooks |
next | string | URL for next page |
Save Audiobooks
Operation
Save Audiobooks
Spotify Account*
Connect spotify...
Audiobook IDs*
Comma-separated audiobook IDs
Save Audiobooks (
spotify_save_audiobooks)Save audiobooks to the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookIds | string | Yes | Comma-separated audiobook IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether audiobooks were saved |
Remove Saved Audiobooks
Operation
Remove Saved Audiobooks
Spotify Account*
Connect spotify...
Audiobook IDs*
Comma-separated audiobook IDs
Remove Saved Audiobooks (
spotify_remove_saved_audiobooks)Remove audiobooks from the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookIds | string | Yes | Comma-separated audiobook IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether audiobooks were removed |
Check Saved Audiobooks
Operation
Check Saved Audiobooks
Spotify Account*
Connect spotify...
Audiobook IDs*
Comma-separated audiobook IDs
Check Saved Audiobooks (
spotify_check_saved_audiobooks)Check if audiobooks are saved in library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
audiobookIds | string | Yes | Comma-separated audiobook IDs (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each audiobook |
Get Playlist
Operation
Get Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Get Playlist (
spotify_get_playlist)Get detailed information about a playlist on Spotify by its ID.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify ID of the playlist |
market | string | No | ISO 3166-1 alpha-2 country code for track availability |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify playlist ID |
name | string | Playlist name |
description | string | Playlist description |
public | boolean | Whether the playlist is public |
collaborative | boolean | Whether the playlist is collaborative |
owner | object | Playlist owner information |
image_url | string | Playlist cover image URL |
total_tracks | number | Total number of tracks |
snapshot_id | string | Playlist snapshot ID for versioning |
external_url | string | Spotify URL |
Get Playlist Tracks
Operation
Get Playlist Tracks
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Limit
Number of results (1-50, default: 20)
Get Playlist Tracks (
spotify_get_playlist_tracks)Get the tracks in a Spotify playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify ID of the playlist |
limit | number | No | Maximum number of tracks to return (1-100) |
offset | number | No | Index of the first track to return |
market | string | No | ISO 3166-1 alpha-2 country code for track availability |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | List of tracks in the playlist |
total | number | Total number of tracks in playlist |
next | string | URL for next page of results |
Get Playlist Cover
Operation
Get Playlist Cover
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Get Playlist Cover (
spotify_get_playlist_cover)Get a playlist's cover image.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
Output
| Parameter | Type | Description |
|---|---|---|
images | json | List of cover images |
Get My Playlists
Operation
Get My Playlists
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get My Playlists (
spotify_get_user_playlists)Get the current user's playlists on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of playlists to return (1-50) |
offset | number | No | Index of the first playlist to return |
Output
| Parameter | Type | Description |
|---|---|---|
playlists | array | User's playlists |
total | number | Total number of playlists |
next | string | URL for next page |
Create Playlist
Operation
Create Playlist
Spotify Account*
Connect spotify...
Playlist Name*
My Awesome Playlist
Playlist Description
Optional description for the playlist
Public
Enabled
Create Playlist (
spotify_create_playlist)Create a new playlist for the current user on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name for the new playlist |
description | string | No | Description for the playlist |
public | boolean | No | Whether the playlist should be public |
collaborative | boolean | No | Whether the playlist should be collaborative (requires public to be false) |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify playlist ID |
name | string | Playlist name |
description | string | Playlist description |
public | boolean | Whether the playlist is public |
collaborative | boolean | Whether collaborative |
snapshot_id | string | Playlist snapshot ID |
external_url | string | Spotify URL |
Update Playlist
Operation
Update Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
New Name
New playlist name (optional)
Playlist Description
Optional description for the playlist
Public
Enabled
Update Playlist (
spotify_update_playlist)Update a playlist's name, description, or visibility.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
name | string | No | New name for the playlist |
description | string | No | New description for the playlist |
public | boolean | No | Whether the playlist should be public |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether update succeeded |
Add Playlist Cover
Operation
Add Playlist Cover
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Image (Base64)*
Base64-encoded JPEG image (max 256KB)
Add Playlist Cover (
spotify_add_playlist_cover)Upload a custom cover image for a playlist. Image must be JPEG and under 256KB.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
imageBase64 | string | Yes | Base64-encoded JPEG image (max 256KB) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether upload succeeded |
Add Tracks to Playlist
Operation
Add Tracks to Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Track URIs*
spotify:track:xxx,spotify:track:yyy
Add Tracks to Playlist (
spotify_add_tracks_to_playlist)Add one or more tracks to a Spotify playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify ID of the playlist |
uris | string | Yes | Comma-separated Spotify URIs (e.g., "spotify:track:xxx,spotify:track:yyy") |
position | number | No | Position to insert tracks (0-based). If omitted, tracks are appended. |
Output
| Parameter | Type | Description |
|---|---|---|
snapshot_id | string | New playlist snapshot ID after modification |
Remove Tracks from Playlist
Operation
Remove Tracks from Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Track URIs*
spotify:track:xxx,spotify:track:yyy
Remove Tracks from Playlist (
spotify_remove_tracks_from_playlist)Remove one or more tracks from a Spotify playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify ID of the playlist |
uris | string | Yes | Comma-separated Spotify URIs to remove (e.g., "spotify:track:xxx,spotify:track:yyy") |
Output
| Parameter | Type | Description |
|---|---|---|
snapshot_id | string | New playlist snapshot ID after modification |
Reorder Playlist Items
Operation
Reorder Playlist Items
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Range Start*
Start index of items to move
Insert Before*
Index to insert before
Range Length
Number of items to move (default: 1)
Reorder Playlist Items (
spotify_reorder_playlist_items)Move tracks to a different position in a playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
range_start | number | Yes | Start index of items to reorder |
insert_before | number | Yes | Index to insert items before |
range_length | number | No | Number of items to reorder |
snapshot_id | string | No | Playlist snapshot ID for concurrency control |
Output
| Parameter | Type | Description |
|---|---|---|
snapshot_id | string | New playlist snapshot ID |
Replace Playlist Items
Operation
Replace Playlist Items
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Track URIs*
spotify:track:xxx,spotify:track:yyy
Replace Playlist Items (
spotify_replace_playlist_items)Replace all items in a playlist with new tracks.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
uris | string | Yes | Comma-separated Spotify URIs (max 100) |
Output
| Parameter | Type | Description |
|---|---|---|
snapshot_id | string | New playlist snapshot ID |
Follow Playlist
Operation
Follow Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Public
Enabled
Follow Playlist (
spotify_follow_playlist)Follow (save) a playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
public | boolean | No | Whether the playlist will be in public playlists |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether follow succeeded |
Unfollow Playlist
Operation
Unfollow Playlist
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
Unfollow Playlist (
spotify_unfollow_playlist)Unfollow (unsave) a playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether unfollow succeeded |
Check Playlist Followers
Operation
Check Playlist Followers
Spotify Account*
Connect spotify...
Playlist ID*
Spotify playlist ID
User IDs*
Comma-separated user IDs to check (max 5)
Check Playlist Followers (
spotify_check_playlist_followers)Check if users follow a playlist.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
playlistId | string | Yes | The Spotify playlist ID |
userIds | string | Yes | Comma-separated user IDs to check (max 5) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of booleans for each user |
Get My Profile
Operation
Get My Profile
Spotify Account*
Connect spotify...
Get My Profile (
spotify_get_current_user)Get the current user's Spotify profile information.
Input
This operation has no direct parameters.
Output
| Parameter | Type | Description |
|---|---|---|
id | string | Spotify user ID |
display_name | string | Display name |
email | string | Email address |
country | string | Country code |
product | string | Subscription level (free, premium) |
followers | number | Number of followers |
image_url | string | Profile image URL |
external_url | string | Spotify profile URL |
Get User Profile
Operation
Get User Profile
Spotify Account*
Connect spotify...
User ID*
Spotify user ID
Get User Profile (
spotify_get_user_profile)Get a user's public profile.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | The Spotify user ID |
Output
| Parameter | Type | Description |
|---|---|---|
id | string | User ID |
display_name | string | Display name |
followers | number | Number of followers |
image_url | string | Profile image URL |
external_url | string | Spotify URL |
Get My Top Tracks
Operation
Get My Top Tracks
Spotify Account*
Connect spotify...
Time Range
Last 6 Months
Limit
Number of results (1-50, default: 20)
Get My Top Tracks (
spotify_get_top_tracks)Get the current user's top tracks based on listening history.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
time_range | string | No | Time range: short_term (~4 weeks), medium_term (~6 months), long_term (years) |
limit | number | No | Number of tracks to return (1-50) |
offset | number | No | Index of the first track to return |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | User's top tracks |
total | number | Total number of top tracks |
next | string | URL for next page |
Get My Top Artists
Operation
Get My Top Artists
Spotify Account*
Connect spotify...
Time Range
Last 6 Months
Limit
Number of results (1-50, default: 20)
Get My Top Artists (
spotify_get_top_artists)Get the current user's top artists based on listening history.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
time_range | string | No | Time range: short_term (~4 weeks), medium_term (~6 months), long_term (years) |
limit | number | No | Number of artists to return (1-50) |
offset | number | No | Index of the first artist to return |
Output
| Parameter | Type | Description |
|---|---|---|
artists | array | User's top artists |
total | number | Total number of top artists |
next | string | URL for next page |
Get Saved Tracks
Operation
Get Saved Tracks
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Saved Tracks (
spotify_get_saved_tracks)Get the current user's saved/liked tracks from their library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of tracks to return (1-50) |
offset | number | No | Index of the first track to return |
market | string | No | ISO 3166-1 alpha-2 country code |
Output
| Parameter | Type | Description |
|---|---|---|
tracks | array | User's saved tracks |
total | number | Total number of saved tracks |
next | string | URL for next page |
Save Tracks
Operation
Save Tracks
Spotify Account*
Connect spotify...
Track IDs*
Comma-separated track IDs
Save Tracks (
spotify_save_tracks)Save tracks to the current user's library (like tracks).
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
trackIds | string | Yes | Comma-separated Spotify track IDs to save (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether the tracks were saved successfully |
Remove Saved Tracks
Operation
Remove Saved Tracks
Spotify Account*
Connect spotify...
Track IDs*
Comma-separated track IDs
Remove Saved Tracks (
spotify_remove_saved_tracks)Remove tracks from the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
trackIds | string | Yes | Comma-separated track IDs to remove (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether tracks were removed successfully |
Check Saved Tracks
Operation
Check Saved Tracks
Spotify Account*
Connect spotify...
Track IDs*
Comma-separated track IDs
Check Saved Tracks (
spotify_check_saved_tracks)Check if one or more tracks are saved in the user's library.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
trackIds | string | Yes | Comma-separated track IDs to check (max 50) |
Output
| Parameter | Type | Description |
|---|---|---|
results | json | Array of track IDs with saved status |
all_saved | boolean | Whether all tracks are saved |
none_saved | boolean | Whether no tracks are saved |
Get Recently Played
Operation
Get Recently Played
Spotify Account*
Connect spotify...
Limit
Number of results (1-50, default: 20)
Get Recently Played (
spotify_get_recently_played)Get the user's recently played tracks.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Number of tracks to return (1-50) |
after | number | No | Unix timestamp in milliseconds. Returns items after this cursor. |
before | number | No | Unix timestamp in milliseconds. Returns items before this cursor. |
Output
| Parameter | Type | Description |
|---|---|---|
items | array | Recently played tracks |
next | string | URL for next page |
Get New Releases
Operation
Get New Releases
Spotify Account*
Connect spotify...
Country
ISO country code (e.g., US, GB)
Limit
Number of results (1-50, default: 20)
Get New Releases (
spotify_get_new_releases)Get a list of new album releases featured in Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | No | ISO 3166-1 alpha-2 country code (e.g., "US", "GB") |
limit | number | No | Number of releases to return (1-50) |
offset | number | No | Index of first release to return |
Output
| Parameter | Type | Description |
|---|---|---|
albums | json | List of new releases |
total | number | Total number of new releases |
next | string | URL for next page |
Get Categories
Operation
Get Categories
Spotify Account*
Connect spotify...
Country
ISO country code (e.g., US, GB)
Limit
Number of results (1-50, default: 20)
Get Categories (
spotify_get_categories)Get a list of browse categories used to tag items in Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | No | ISO 3166-1 alpha-2 country code (e.g., "US", "GB") |
locale | string | No | Locale code (e.g., "en_US", "es_MX") |
limit | number | No | Number of categories to return (1-50) |
Output
| Parameter | Type | Description |
|---|---|---|
categories | json | List of browse categories |
total | number | Total number of categories |
Get Available Markets
Operation
Get Available Markets
Spotify Account*
Connect spotify...
Get Available Markets (
spotify_get_markets)Get the list of markets where Spotify is available.
Input
This operation has no direct parameters.
Output
| Parameter | Type | Description |
|---|---|---|
markets | json | List of ISO country codes |
Get Playback State
Operation
Get Playback State
Spotify Account*
Connect spotify...
Get Playback State (
spotify_get_playback_state)Get the current playback state including device, track, and progress.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
market | string | No | ISO 3166-1 alpha-2 country code |
Output
| Parameter | Type | Description |
|---|---|---|
is_playing | boolean | Whether playback is active |
device | object | Active device information |
progress_ms | number | Progress in milliseconds |
currently_playing_type | string | Type of content playing |
shuffle_state | boolean | Whether shuffle is enabled |
repeat_state | string | Repeat mode (off, track, context) |
track | object | Currently playing track |
Get Currently Playing
Operation
Get Currently Playing
Spotify Account*
Connect spotify...
Get Currently Playing (
spotify_get_currently_playing)Get the user's currently playing track.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
market | string | No | ISO country code for market |
Output
| Parameter | Type | Description |
|---|---|---|
is_playing | boolean | Whether playback is active |
progress_ms | number | Current position in track (ms) |
track | json | Currently playing track |
Get Devices
Operation
Get Devices
Spotify Account*
Connect spotify...
Get Devices (
spotify_get_devices)Get the user's available Spotify playback devices.
Input
This operation has no direct parameters.
Output
| Parameter | Type | Description |
|---|---|---|
devices | array | Available playback devices |
Get Queue
Operation
Get Queue
Spotify Account*
Connect spotify...
Get Queue (
spotify_get_queue)Get the user's playback queue.
Input
This operation has no direct parameters.
Output
| Parameter | Type | Description |
|---|---|---|
currently_playing | json | Currently playing track |
queue | json | Upcoming tracks in queue |
Play
Operation
Play
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Context URI
spotify:album:xxx or spotify:playlist:yyy
Track URIs
spotify:track:xxx (comma-separated for multiple)
Play (
spotify_play)Start or resume playback on Spotify. Can play specific tracks, albums, or playlists.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | No | Device ID to play on. If not provided, plays on active device. |
context_uri | string | No | Spotify URI of album, artist, or playlist to play (e.g., "spotify:album:xxx") |
uris | string | No | Comma-separated track URIs to play (e.g., "spotify:track:xxx,spotify:track:yyy") |
offset | number | No | Position in context to start playing (0-based index) |
position_ms | number | No | Position in track to start from (in milliseconds) |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether playback started successfully |
Pause
Operation
Pause
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Pause (
spotify_pause)Pause playback on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | No | Device ID to pause. If not provided, pauses active device. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether playback was paused |
Skip to Next
Operation
Skip to Next
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Skip to Next (
spotify_skip_next)Skip to the next track on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | No | Device ID. If not provided, uses active device. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether skip was successful |
Skip to Previous
Operation
Skip to Previous
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Skip to Previous (
spotify_skip_previous)Skip to the previous track on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | No | Device ID. If not provided, uses active device. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether skip was successful |
Seek
Operation
Seek
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Position (ms)*
Position in milliseconds
Seek (
spotify_seek)Seek to a position in the currently playing track.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
position_ms | number | Yes | Position in milliseconds to seek to |
device_id | string | No | Device ID to target |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether seek was successful |
Add to Queue
Operation
Add to Queue
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Track URI*
spotify:track:xxx
Add to Queue (
spotify_add_to_queue)Add a track to the user's playback queue.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
uri | string | Yes | Spotify URI of the track to add (e.g., "spotify:track:xxx") |
device_id | string | No | Device ID. If not provided, uses active device. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether track was added to queue |
Set Volume
Operation
Set Volume
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Volume
0
Set Volume (
spotify_set_volume)Set the playback volume on Spotify.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
volume_percent | number | Yes | Volume level (0 to 100) |
device_id | string | No | Device ID. If not provided, uses active device. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether volume was set |
Set Repeat
Operation
Set Repeat
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Repeat Mode
Off
Set Repeat (
spotify_set_repeat)Set the repeat mode for playback.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
state | string | Yes | Repeat mode: "off", "track", or "context" |
device_id | string | No | Device ID to target |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether repeat mode was set successfully |
Set Shuffle
Operation
Set Shuffle
Spotify Account*
Connect spotify...
Device ID
Optional - uses active device if not specified
Shuffle
Disabled
Set Shuffle (
spotify_set_shuffle)Turn shuffle on or off.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
state | boolean | Yes | true for shuffle on, false for off |
device_id | string | No | Device ID to target |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether shuffle was set successfully |
Transfer Playback
Operation
Transfer Playback
Spotify Account*
Connect spotify...
Target Device ID*
Device ID to transfer to
Transfer Playback (
spotify_transfer_playback)Transfer playback to a different device.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | Yes | Device ID to transfer playback to |
play | boolean | No | Whether to start playing on the new device |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether transfer was successful |
Usage Instructions
Integrate Spotify into your workflow. Search for tracks, albums, artists, and playlists. Manage playlists, access your library, control playback, browse podcasts and audiobooks.
Notes
- Category:
tools - Type:
spotify