# Spotify

Control Spotify playback and search the library and playlists.

- Repository: https://github.com/codewhale-hq/Codewhale (41164 stars)
- Category: Media
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add codewhale-hq/Codewhale --skill spotify -g -a claude-code -y`
Codex: `npx skills add codewhale-hq/Codewhale --skill spotify -g -a codex -y`
Cursor: `npx skills add codewhale-hq/Codewhale --skill spotify -g -a cursor -y`
Gemini CLI: `npx skills add codewhale-hq/Codewhale --skill spotify -g -a gemini-cli -y`

## Description

Control Spotify playback and search the library and playlists. Use when: spotify, music, playlist, play, pause, or what's playing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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](https://developer.spotify.com/blog/2024-11-27-changes-to-the-web-api).