Spotify

PocketPaw integrates with Spotify for music search, playback control, and playlist management.

Setup

Create Spotify app

Go to developer.spotify.com/dashboard and create a new app.

Set redirect URI

Add http://localhost:8888/callback as a redirect URI.

Configure

Terminal window
export POCKETCLAW_SPOTIFY_CLIENT_ID="your-client-id"
export POCKETCLAW_SPOTIFY_CLIENT_SECRET="your-secret"

Authorize

The first time you use a Spotify tool, PocketPaw will open a browser for authorization.

Tools

Search for tracks, albums, or artists:

User: Find songs by Radiohead
Agent: [uses spotify_search] → Top results:
  1. "Creep" - Radiohead (Pablo Honey)
  2. "Karma Police" - Radiohead (OK Computer)
  3. "No Surprises" - Radiohead (OK Computer)

spotify_now_playing

Get the currently playing track:

User: What's playing right now?
Agent: [uses spotify_now_playing] → Now playing: "Bohemian Rhapsody" by Queen (3:24/5:55)

spotify_playback

Control playback (play, pause, skip, volume):

User: Skip to the next track
Agent: [uses spotify_playback] → Skipped to next track


User: Set volume to 50%
Agent: [uses spotify_playback] → Volume set to 50%

spotify_playlist

Manage playlists:

User: Add the current song to my favorites playlist
Agent: [uses spotify_playlist] → Added "Bohemian Rhapsody" to "Favorites"

Policy Group

All Spotify tools belong to group:spotify.

Required Scopes

  • user-read-playback-state
  • user-modify-playback-state
  • user-read-currently-playing
  • playlist-modify-public
  • playlist-modify-private
Info

Spotify requires an active Spotify Premium account for playback control.

Last updated: February 12, 2026
Edit this page