Menu
Play, pause, skip, search and control Spotify playback. Requires Spotify OAuth. Tools: http, intent, accessibility (only for NO_ACTIVE_DEVICE recovery).
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | spotify |
| description | Play, pause, skip, search and control Spotify playback. Requires Spotify OAuth. Tools: http, intent, accessibility (only for NO_ACTIVE_DEVICE recovery). |
Control Spotify playback via the Web API and app intents.
All requests require auth_provider: "spotify".
Base URL: https://api.spotify.com/v1
{
"method": "GET",
"url": "https://api.spotify.com/v1/me/player/currently-playing",
"auth_provider": "spotify"
}
{
"method": "PUT",
"url": "https://api.spotify.com/v1/me/player/play",
"auth_provider": "spotify"
}
{
"method": "PUT",
"url": "https://api.spotify.com/v1/me/player/pause",
"auth_provider": "spotify"
}
{
"method": "POST",
"url": "https://api.spotify.com/v1/me/player/next",
"auth_provider": "spotify"
}
{
"method": "POST",
"url": "https://api.spotify.com/v1/me/player/previous",
"auth_provider": "spotify"
}
{
"method": "GET",
"url": "https://api.spotify.com/v1/search?q={SEARCH_TERM}&type=track,artist,playlist&limit=5",
"auth_provider": "spotify"
}
{
"method": "PUT",
"url": "https://api.spotify.com/v1/me/player/play",
"auth_provider": "spotify",
"body": {
"context_uri": "spotify:artist:{ARTIST_ID}"
}
}
Or for individual tracks:
{
"body": {
"uris": ["spotify:track:{TRACK_ID}"]
}
}
{
"method": "PUT",
"url": "https://api.spotify.com/v1/me/player/volume?volume_percent={0-100}",
"auth_provider": "spotify"
}
{
"action": "android.intent.action.VIEW",
"uri": "spotify:track:{TRACK_ID}",
"package": "com.spotify.music"
}
IMPORTANT: Use accessibility ONLY when the Web API returns a NO_ACTIVE_DEVICE error (HTTP 404 with "reason": "NO_ACTIVE_DEVICE"). All other actions (pause, next, previous, volume, search, play specific tracks) MUST be done via the Web API.
If any playback API call returns HTTP 404 / NO_ACTIVE_DEVICE, Spotify has no active player on any device. Fix this by opening Spotify and selecting this phone as the active device:
{
"package_name": "com.spotify.music",
"goal": "Open Spotify. In the mini-player bar at the bottom of the screen, tap the devices/connect icon (the monitor icon to the left of the + button). A bottom sheet titled 'Connect' will appear. In that sheet, tap the first row that shows a smartphone icon – it represents this phone (labeled 'Dieses Smartphone' in German or 'This phone' / 'This device' in English). Tap it to activate playback on this device."
}
After the accessibility tool completes, immediately retry the original API play call (with the same URI/body as before).
Note: Once this phone is selected as the active device, all further control (pause, next, previous, volume) should be done via the Web API, NOT via accessibility.
httpHTTP 404 / NO_ACTIVE_DEVICE: use the accessibility tool (see above) to activate this phone, then retry the play callPUT /me/player/play (no body) to resume
HTTP 404 / NO_ACTIVE_DEVICE: use the accessibility tool to activate this phone, then retrySearch, subscribe, and listen to podcasts. Download RSS feeds, manage episodes, and play audio with position tracking. Tools: http, file_storage, media_queue, play_audio.
Manage local lists (shopping, to-do, etc.) stored as files. Add, remove, check and read items. Tools: file_storage.
Read, create, update and delete Google Calendar events. Requires Google OAuth. Tools: http.
Search contacts by name and retrieve phone numbers. Use before calling or sending SMS. Tools: query.
Read, search and send emails via Gmail API. Requires Google OAuth. Tools: gmail_send, http.
Start navigation, get directions and route info via Google Maps app. Tools: intent, http (optional, requires Maps API key for traffic/route details).