Spotify

The Spotify toolkit integrates Arcade with the Spotify Web API, enabling LLMs to control playback, query catalog data, and inspect device/playback state on behalf of authenticated users.

Capabilities

Playback control: Pause, resume, skip to next/previous track, seek to an absolute or relative position within the current track (with automatic boundary clamping), and start playback for a specific list of track IDs.
Contextual playback: Play tracks or artists by name (playing by artist also auto-queues four additional songs by the same artist).
State inspection: Retrieve the full playback state (track/episode, active device, progress) or a focused view of just the currently playing item — read-only, no side effects.
Device management: List all available Spotify-connected devices for the authenticated user.
Catalog search: Search the Spotify catalog with support for field filters (album, artist, track, year, genre, isrc, upc, tag:hipster, tag:new) across multiple result types; supports single-year and year-range filtering.
Track lookup: Fetch detailed metadata for a track by its Spotify track ID.

OAuth

This toolkit uses OAuth 2.0 via the Spotify auth provider. See the Arcade Spotify provider docs for setup details.

	Tool name	Description	Secrets
	Spotify.AdjustPlaybackPosition	Adjust the playback position within the currently playing track. Knowledge of the current playback state is NOT needed to use this tool as it handles clamping the position to valid start/end boundaries to prevent overshooting or negative values. This tool allows you to seek to a specific position within the currently playing track. You can either provide an absolute position in milliseconds or a relative position from the current playback position in milliseconds. Note: Either absolute_position_ms or relative_position_ms must be provided, but not both.
	Spotify.GetAvailableDevices	Get the available devices
	Spotify.GetCurrentlyPlaying	Get information about the user's currently playing track
	Spotify.GetPlaybackState	Get information about the user's current playback state, including track or episode, and active device. This tool does not perform any actions. Use other tools to control playback.
	Spotify.GetTrackFromId	Get information about a track
	Spotify.PausePlayback	Pause the currently playing track, if any
	Spotify.PlayArtistByName	Plays a song by an artist and queues four more songs by the same artist
	Spotify.PlayTrackByName	Plays a song by name
	Spotify.ResumePlayback	Resume the currently playing track, if any
	Spotify.Search	Search Spotify catalog information Explanation of the q parameter: You can narrow down your search using field filters. Available filters are album, artist, track, year, upc, tag:hipster, tag:new, isrc, and genre. Each field filter only applies to certain result types. The artist and year filters can be used while searching albums, artists and tracks. You can filter on a single year or a range (e.g. 1955-1960). The album filter can be used while searching albums and tracks. The genre filter can be used while searching artists and tracks. The isrc and track filters can be used while searching tracks. The upc, tag:new and tag:hipster filters can only be used while searching albums. The tag:new filter will return albums released in the past two weeks and tag:hipster can be used to return only albums with the lowest 10% popularity. Example: q="remaster track:Doxy artist:Miles Davis"
	Spotify.SkipToNextTrack	Skip to the next track in the user's queue, if any
	Spotify.SkipToPreviousTrack	Skip to the previous track in the user's queue, if any
	Spotify.StartTracksPlaybackById	Start playback of a list of tracks (songs)

Capabilities

OAuth

Available tools(13)

Get Building