Spotify
Search and manage Spotify tracks, playlists, library, and playback across music, podcasts, and audiobooks.
Categories: Music, Entertainment
What you can ask
- Build a focus playlist of 50 ambient tracks I haven't heard before.
- Find every song saved in the last 30 days that was added to a friend's playlist.
- Pull my top 50 most-played tracks from the last 6 months.
Set up
Spotify needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Spotify. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Spotify developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Spotify login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (16)
Grant the scopes for the tools you plan to allow.
playlist-modify-privateplaylist-modify-publicplaylist-read-collaborativeplaylist-read-privateuser-follow-modifyuser-follow-readuser-library-modifyuser-library-readuser-modify-playback-stateuser-read-currently-playinguser-read-emailuser-read-playback-positionuser-read-playback-stateuser-read-privateuser-read-recently-playeduser-top-read
Tools
Spotify offers 49 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (30)
View and search information without changing it.
| Tool | What it does |
|---|---|
check_library | Check if tracks, albums, shows, episodes, or audiobooks are saved in the user's library. |
get_album | Get details for a Spotify album by ID. |
get_artist | Get details for a Spotify artist by ID. |
get_audiobook | Get details for a Spotify audiobook by ID. |
get_chapter | Get details for a Spotify audiobook chapter by ID. |
get_current_user | Get the current user's Spotify profile. |
get_currently_playing | Get the currently playing track or episode. |
get_devices | Get the user's available Spotify devices. |
get_episode | Get details for a Spotify episode by ID. |
get_playback_state | Get the current playback state including device, repeat/shuffle mode, playing item, and progress. |
get_playlist | Get details for a Spotify playlist by ID. |
get_recently_played | Get the user's recently played tracks. |
get_show | Get details for a Spotify show/podcast by ID. |
get_track | Get details for a Spotify track by ID. |
get_user_queue | Get the user's playback queue. |
get_user_top_items | Get the user's top artists or tracks based on listening history. |
list_album_tracks | List tracks in a Spotify album with pagination. |
list_artist_albums | List albums by a Spotify artist with pagination. |
list_audiobook_chapters | List chapters of a Spotify audiobook with pagination. |
list_followed_artists | List artists the user follows. |
list_playlist_items | List items (tracks/episodes) in a playlist with pagination. |
list_saved_albums | List the current user's saved albums with pagination. |
list_saved_audiobooks | List the current user's saved audiobooks with pagination. |
list_saved_episodes | List the current user's saved episodes with pagination. |
list_saved_shows | List the current user's saved shows/podcasts with pagination. |
list_saved_tracks | List the current user's saved tracks with pagination. |
list_show_episodes | List episodes of a Spotify show/podcast with pagination. |
list_user_playlists | List the current user's playlists with pagination. |
search | Search Spotify for tracks, albums, artists, playlists, shows, episodes, or audiobooks. |
validate_credential | Validate Spotify credentials by fetching the current user profile. |
Write (5)
Create or send data.
| Tool | What it does |
|---|---|
add_playlist_items | Add tracks/episodes to a playlist. |
add_to_queue | Add a track or episode to the playback queue. |
create_playlist | Create a new playlist for the current user. |
follow | Follow artists or users on Spotify. |
save_to_library | Save tracks, albums, shows, episodes, or audiobooks to the user's library. |
Delete or overwrite (14)
Remove or replace existing data.
| Tool | What it does |
|---|---|
pause_playback | Pause playback on the active device. |
remove_from_library | Remove tracks, albums, shows, episodes, or audiobooks from the user's library. |
remove_playlist_items | Remove tracks/episodes from a playlist by URI. |
reorder_playlist_items | Reorder items in a playlist. |
seek | Seek to a position in the current track. |
set_repeat | Set repeat mode: 'track' (repeat current), 'context' (repeat album/playlist), or 'off'. |
set_shuffle | Enable or disable shuffle mode. |
set_volume | Set playback volume (0-100). |
skip_next | Skip to the next track. |
skip_previous | Skip to the previous track. |
start_playback | Start or resume playback. |
transfer_playback | Transfer playback to another device. |
unfollow | Unfollow artists or users on Spotify. |
update_playlist | Update a playlist's name, description, or visibility. |