Spotify

When to use

Playing, pausing, skipping, identifying the current track, searching for music, and reading playlists.

Setup

Two paths:

1. Local control (macOS, no setup). The Spotify desktop app must be running, or say so: osascript -e 'tell application "Spotify" to playpause'
2. Web API (search, playlists, other platforms). Requires an authorized Spotify connection with suitable scopes; report missing access without asking the user to paste a token into chat: GET api.spotify.com/v1/search, /v1/me/playlists, /v1/playlists/{id}.

Workflow

1. Prefer local control for transport (play/pause/next/previous/current track). Use the requested play or pause verb; playpause is a toggle and cannot safely be retried after an uncertain result. Verify player state afterward.
2. Use available Web API endpoints for search and playlist contents. Check current app-access restrictions; do not promise the restricted Recommendations API. Handle 403/429 responses without bypassing access or rate limits.
3. Report artist, track, album, and playlist names verbatim.

Non-goals

• Do not change playlists (add/remove/reorder) unless asked.
• Do not download or rip audio.
• Do not handle the user's Spotify password.

Reference: Spotify API changes.