How do I install the Spotify Claw skill?

Run npx skillmds@latest add dvcrn/spotify-claw in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Spotify Claw safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Spotify Claw?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Spotify Claw free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Spotify Claw?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Spotify Claw by dvcrn — Agent Skill

Name: Spotify Claw
Rating: 4.5 (4 reviews)
Author: dvcrn

Spotify Claw

Full Spotify Premium control + music analysis. Playback: play/pause/next/prev/volume/shuffle/queue. Analysis: top tracks, top artists, liked songs, genre profile, taste breakdown. Discovery: find similar artists & music without Recommendations API. Playlist builder: make-playlist, liked-by-artist, discover. Auto-launches Spotify if closed. Credentials via macOS Keychain. Triggers: play music, pause, next track, what's playing, top tracks, playlist, genres, similar music, open spotify.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

spotify-claw

Full Spotify Premium control with music analysis and smart discovery.

ALWAYS run python3 ~/.openclaw/scripts/spotify.py [cmd] — never respond with text only.

Setup (first time)

Create app at developer.spotify.com/dashboard — Add redirect URI: http://127.0.0.1:8888/callback
Add to macOS Keychain:

security add-generic-password -a openclaw -s openclaw.spotify.client_id -w "CLIENT_ID"
security add-generic-password -a openclaw -s openclaw.spotify.client_secret -w "CLIENT_SECRET"

First auth — run now, browser opens, log in once:

python3 ~/.openclaw/scripts/spotify.py now

Playback Commands

python3 ~/.openclaw/scripts/spotify.py play                          # resume
python3 ~/.openclaw/scripts/spotify.py play "track name"             # search & play
python3 ~/.openclaw/scripts/spotify.py play spotify:track:URI        # by URI
python3 ~/.openclaw/scripts/spotify.py play spotify:playlist:ID      # playlist
python3 ~/.openclaw/scripts/spotify.py pause
python3 ~/.openclaw/scripts/spotify.py next
python3 ~/.openclaw/scripts/spotify.py prev
python3 ~/.openclaw/scripts/spotify.py volume 70
python3 ~/.openclaw/scripts/spotify.py volume up
python3 ~/.openclaw/scripts/spotify.py volume down
python3 ~/.openclaw/scripts/spotify.py shuffle on
python3 ~/.openclaw/scripts/spotify.py shuffle off
python3 ~/.openclaw/scripts/spotify.py queue "track name"
python3 ~/.openclaw/scripts/spotify.py now
python3 ~/.openclaw/scripts/spotify.py devices

Auto-launch: If Spotify is closed, play opens the app automatically, waits for init, then plays.

Analysis Commands

python3 ~/.openclaw/scripts/spotify.py top-tracks [short|medium|long] [limit]
python3 ~/.openclaw/scripts/spotify.py top-artists [short|medium|long] [limit]
python3 ~/.openclaw/scripts/spotify.py recent [limit]
python3 ~/.openclaw/scripts/spotify.py liked [limit]
python3 ~/.openclaw/scripts/spotify.py liked-all
python3 ~/.openclaw/scripts/spotify.py liked-by-artist "Artist Name"
python3 ~/.openclaw/scripts/spotify.py genres [short|medium|long]
python3 ~/.openclaw/scripts/spotify.py playlists
python3 ~/.openclaw/scripts/spotify.py search "query" [track|artist|album] [limit]
python3 ~/.openclaw/scripts/spotify.py track-info URI

Periods: short = 4 weeks · medium = 6 months · long = all time

Discovery & Playlist Builder

# Find new music by genre profile
python3 ~/.openclaw/scripts/spotify.py discover

# Expand from specific artist (depth=hops, n=tracks per artist)
python3 ~/.openclaw/scripts/spotify.py discover "Portishead" 3 3

# Related artists
python3 ~/.openclaw/scripts/spotify.py related-artists "The Cure" 10

# Top tracks of any artist
python3 ~/.openclaw/scripts/spotify.py artist-top-tracks "Massive Attack" 5

# Create playlist from top tracks (one command: creates + fills)
python3 ~/.openclaw/scripts/spotify.py make-playlist "Top March 2026" short 20

# Manage playlists
python3 ~/.openclaw/scripts/spotify.py create-playlist "My Playlist" "Description"
python3 ~/.openclaw/scripts/spotify.py add-to-playlist PLAYLIST_ID URI1 URI2

Note: Spotify's recommendations and audio_features APIs are blocked for new developer apps (return 403/404). This skill uses related_artists + artist_top_tracks for discovery instead.

Agent Tips

Use playlists to list user's playlists with IDs before playing one
Use now to confirm what's playing after a play command
Use liked-by-artist to find tracks for a themed playlist
Chain: related-artists → artist-top-tracks → add-to-playlist for smart playlist building
genres long gives the most accurate taste profile

---name: spotify-clawdescription: Full Spotify Premium control + music analysis. Playback: play/pause/next/prev/volume/shuffle/queue. Analysis: top tracks, top artists, liked songs, genre profile, taste breakdown. Discovery: find similar artists & music without Recommendations API. Playlist builder: make-playlist, liked-by-artist, discover. Auto-launches Spotify if closed. Credentials via macOS Keychain. Triggers: play music, pause, next track, what's playing, top tracks, playlist, genres, similar music, open spotify.---# spotify-clawFull Spotify Premium control with music analysis and smart discovery.> **ALWAYS run `python3 ~/.openclaw/scripts/spotify.py [cmd]`** — never respond with text only.---## Setup (first time)1. Create app at [developer.spotify.com/dashboard](https://developer.spotify.com/dashboard) — Add redirect URI: `http://127.0.0.1:8888/callback`2. Add to macOS Keychain:```bashsecurity add-generic-password -a openclaw -s openclaw.spotify.client_id -w "CLIENT_ID"security add-generic-password -a openclaw -s openclaw.spotify.client_secret -w "CLIENT_SECRET"```3. First auth — run `now`, browser opens, log in once:```bashpython3 ~/.openclaw/scripts/spotify.py now```---## Playback Commands```bashpython3 ~/.openclaw/scripts/spotify.py play # resumepython3 ~/.openclaw/scripts/spotify.py play "track name" # search & playpython3 ~/.openclaw/scripts/spotify.py play spotify:track:URI # by URIpython3 ~/.openclaw/scripts/spotify.py play spotify:playlist:ID # playlistpython3 ~/.openclaw/scripts/spotify.py pausepython3 ~/.openclaw/scripts/spotify.py nextpython3 ~/.openclaw/scripts/spotify.py prevpython3 ~/.openclaw/scripts/spotify.py volume 70python3 ~/.openclaw/scripts/spotify.py volume uppython3 ~/.openclaw/scripts/spotify.py volume downpython3 ~/.openclaw/scripts/spotify.py shuffle onpython3 ~/.openclaw/scripts/spotify.py shuffle offpython3 ~/.openclaw/scripts/spotify.py queue "track name"python3 ~/.openclaw/scripts/spotify.py nowpython3 ~/.openclaw/scripts/spotify.py devices```**Auto-launch:** If Spotify is closed, `play` opens the app automatically, waits for init, then plays.---## Analysis Commands```bashpython3 ~/.openclaw/scripts/spotify.py top-tracks [short|medium|long] [limit]python3 ~/.openclaw/scripts/spotify.py top-artists [short|medium|long] [limit]python3 ~/.openclaw/scripts/spotify.py recent [limit]python3 ~/.openclaw/scripts/spotify.py liked [limit]python3 ~/.openclaw/scripts/spotify.py liked-allpython3 ~/.openclaw/scripts/spotify.py liked-by-artist "Artist Name"python3 ~/.openclaw/scripts/spotify.py genres [short|medium|long]python3 ~/.openclaw/scripts/spotify.py playlistspython3 ~/.openclaw/scripts/spotify.py search "query" [track|artist|album] [limit]python3 ~/.openclaw/scripts/spotify.py track-info URI```Periods: `short` = 4 weeks · `medium` = 6 months · `long` = all time---## Discovery & Playlist Builder```bash# Find new music by genre profilepython3 ~/.openclaw/scripts/spotify.py discover# Expand from specific artist (depth=hops, n=tracks per artist)python3 ~/.openclaw/scripts/spotify.py discover "Portishead" 3 3# Related artistspython3 ~/.openclaw/scripts/spotify.py related-artists "The Cure" 10# Top tracks of any artistpython3 ~/.openclaw/scripts/spotify.py artist-top-tracks "Massive Attack" 5# Create playlist from top tracks (one command: creates + fills)python3 ~/.openclaw/scripts/spotify.py make-playlist "Top March 2026" short 20# Manage playlistspython3 ~/.openclaw/scripts/spotify.py create-playlist "My Playlist" "Description"python3 ~/.openclaw/scripts/spotify.py add-to-playlist PLAYLIST_ID URI1 URI2```> **Note:** Spotify's `recommendations` and `audio_features` APIs are blocked for new developer apps (return 403/404). This skill uses `related_artists` + `artist_top_tracks` for discovery instead.---## Agent Tips- Use `playlists` to list user's playlists with IDs before playing one- Use `now` to confirm what's playing after a `play` command- Use `liked-by-artist` to find tracks for a themed playlist- Chain: `related-artists` → `artist-top-tracks` → `add-to-playlist` for smart playlist building- `genres long` gives the most accurate taste profile

Frequently asked questions