Skip to main content

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.

  1. Go to Organization > Connectors and find Spotify. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Spotify developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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-private
  • playlist-modify-public
  • playlist-read-collaborative
  • playlist-read-private
  • user-follow-modify
  • user-follow-read
  • user-library-modify
  • user-library-read
  • user-modify-playback-state
  • user-read-currently-playing
  • user-read-email
  • user-read-playback-position
  • user-read-playback-state
  • user-read-private
  • user-read-recently-played
  • user-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.

ToolWhat it does
check_libraryCheck if tracks, albums, shows, episodes, or audiobooks are saved in the user's library.
get_albumGet details for a Spotify album by ID.
get_artistGet details for a Spotify artist by ID.
get_audiobookGet details for a Spotify audiobook by ID.
get_chapterGet details for a Spotify audiobook chapter by ID.
get_current_userGet the current user's Spotify profile.
get_currently_playingGet the currently playing track or episode.
get_devicesGet the user's available Spotify devices.
get_episodeGet details for a Spotify episode by ID.
get_playback_stateGet the current playback state including device, repeat/shuffle mode, playing item, and progress.
get_playlistGet details for a Spotify playlist by ID.
get_recently_playedGet the user's recently played tracks.
get_showGet details for a Spotify show/podcast by ID.
get_trackGet details for a Spotify track by ID.
get_user_queueGet the user's playback queue.
get_user_top_itemsGet the user's top artists or tracks based on listening history.
list_album_tracksList tracks in a Spotify album with pagination.
list_artist_albumsList albums by a Spotify artist with pagination.
list_audiobook_chaptersList chapters of a Spotify audiobook with pagination.
list_followed_artistsList artists the user follows.
list_playlist_itemsList items (tracks/episodes) in a playlist with pagination.
list_saved_albumsList the current user's saved albums with pagination.
list_saved_audiobooksList the current user's saved audiobooks with pagination.
list_saved_episodesList the current user's saved episodes with pagination.
list_saved_showsList the current user's saved shows/podcasts with pagination.
list_saved_tracksList the current user's saved tracks with pagination.
list_show_episodesList episodes of a Spotify show/podcast with pagination.
list_user_playlistsList the current user's playlists with pagination.
searchSearch Spotify for tracks, albums, artists, playlists, shows, episodes, or audiobooks.
validate_credentialValidate Spotify credentials by fetching the current user profile.

Write (5)​

Create or send data.

ToolWhat it does
add_playlist_itemsAdd tracks/episodes to a playlist.
add_to_queueAdd a track or episode to the playback queue.
create_playlistCreate a new playlist for the current user.
followFollow artists or users on Spotify.
save_to_librarySave tracks, albums, shows, episodes, or audiobooks to the user's library.

Delete or overwrite (14)​

Remove or replace existing data.

ToolWhat it does
pause_playbackPause playback on the active device.
remove_from_libraryRemove tracks, albums, shows, episodes, or audiobooks from the user's library.
remove_playlist_itemsRemove tracks/episodes from a playlist by URI.
reorder_playlist_itemsReorder items in a playlist.
seekSeek to a position in the current track.
set_repeatSet repeat mode: 'track' (repeat current), 'context' (repeat album/playlist), or 'off'.
set_shuffleEnable or disable shuffle mode.
set_volumeSet playback volume (0-100).
skip_nextSkip to the next track.
skip_previousSkip to the previous track.
start_playbackStart or resume playback.
transfer_playbackTransfer playback to another device.
unfollowUnfollow artists or users on Spotify.
update_playlistUpdate a playlist's name, description, or visibility.
⌘J