Awesome-openclaw-skills spotify-applescript

Control Spotify desktop app via AppleScript. Play playlists, tracks, albums, episodes, and manage playback. Works reliably with macOS Spotify app without API keys or OAuth.

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/spotify-applescript" ~/.claude/skills/sundial-org-awesome-openclaw-skills-spotify-applescript && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/spotify-applescript" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-spotify-applescript && rm -rf "$T"

manifest: skills/spotify-applescript/SKILL.md

source content

Spotify AppleScript Control

Control the Spotify desktop app using AppleScript. Works reliably with the macOS Spotify app without API rate limits or OAuth.

Requirements

Spotify desktop app installed and running on macOS
No setup required - just works

Quick Start

# Play a playlist
spotify play "spotify:playlist:665eC1myDA8iSepZ0HOZdG"
spotify play "https://open.spotify.com/playlist/665eC1myDA8iSepZ0HOZdG"

# Play an episode
spotify play "spotify:episode:5yJKH11UlF3sS3gcKKaUYx"
spotify play "https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx"

# Play a track
spotify play "spotify:track:7hQJA50XrCWABAu5v6QZ4i"

# Playback control
spotify pause          # Toggle play/pause
spotify next           # Next track
spotify prev           # Previous track
spotify status         # Current track info

# Volume control
spotify volume 50      # Set volume (0-100)
spotify mute           # Mute
spotify unmute         # Unmute

Spotify CLI Wrapper

The

spotify

command is a wrapper script at

{baseDir}/spotify.sh

Commands

Command	Description	Example
`play <uri>`	Play track/album/playlist/episode	`spotify play spotify:track:xxx`
`pause`	Toggle play/pause	`spotify pause`
`next`	Next track	`spotify next`
`prev`	Previous track	`spotify prev`
`status`	Show current track info	`spotify status`
`volume <0-100>`	Set volume	`spotify volume 75`
`mute`	Mute	`spotify mute`
`unmute`	Unmute	`spotify unmute`

URI Formats

Accepts both Spotify URIs and open.spotify.com URLs:

```
spotify:track:7hQJA50XrCWABAu5v6QZ4i
```

https://open.spotify.com/track/7hQJA50XrCWABAu5v6QZ4i

```
spotify:playlist:665eC1myDA8iSepZ0HOZdG
```

https://open.spotify.com/playlist/665eC1myDA8iSepZ0HOZdG?si=xxx

```
spotify:episode:5yJKH11UlF3sS3gcKKaUYx
```

https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx

```
spotify:album:xxx
```
```
spotify:artist:xxx
```

The script auto-converts URLs to URIs.

Direct AppleScript Commands

For more control, use AppleScript directly:

# Play
osascript -e 'tell application "Spotify" to play track "spotify:playlist:xxx"'

# Pause/Play toggle
osascript -e 'tell application "Spotify" to playpause'

# Next/Previous
osascript -e 'tell application "Spotify" to next track'
osascript -e 'tell application "Spotify" to previous track'

# Get current track
osascript -e 'tell application "Spotify"
  set trackName to name of current track
  set artistName to artist of current track
  return trackName & " by " & artistName
end tell'

# Get player state
osascript -e 'tell application "Spotify" to player state'

# Set volume (0-100)
osascript -e 'tell application "Spotify" to set sound volume to 75'

# Get current position (in seconds)
osascript -e 'tell application "Spotify" to player position'

# Set position (in seconds)
osascript -e 'tell application "Spotify" to set player position to 30'

Available Properties

tell application "Spotify"
  name of current track          -- Track name
  artist of current track        -- Artist name
  album of current track         -- Album name
  duration of current track      -- Duration in ms
  player position                -- Position in seconds
  player state                   -- playing/paused/stopped
  sound volume                   -- 0-100
  repeating                      -- true/false
  repeating enabled              -- true/false
  shuffling                      -- true/false
  shuffling enabled              -- true/false
end tell

Examples

Agent Usage

When the user says:

"Play my power hour playlist" → extract playlist URI and run
```
spotify play <uri>
```
"Pause the music" → run
```
spotify pause
```
"Next track" → run
```
spotify next
```
"What's playing?" → run
```
spotify status
```

Play a specific episode

spotify play https://open.spotify.com/episode/5yJKH11UlF3sS3gcKKaUYx

Get full track info

osascript -e 'tell application "Spotify"
  return "Track: " & (name of current track) & "\nArtist: " & (artist of current track) & "\nAlbum: " & (album of current track) & "\nState: " & (player state as string)
end tell'

Installation

The skill is self-contained. To make the

spotify

command available system-wide:

chmod +x {baseDir}/spotify.sh
sudo ln -sf {baseDir}/spotify.sh /usr/local/bin/spotify

Or add the skill directory to PATH.

Troubleshooting

"Spotify got an error"

Make sure Spotify desktop app is running
Spotify must be launched at least once to accept AppleScript commands

Play command does nothing

Verify the URI format is correct
Try playing from Spotify app first to ensure the content exists

No audio

Check system volume and Spotify app volume
Ensure correct output device is selected in Spotify preferences

Limitations

Requires Spotify desktop app to be running
macOS only (uses AppleScript)
Cannot search or browse library (use web interface or app for discovery)
Cannot manage playlists (add/remove tracks)

For playlist management and search, use the web interface or consider the

spotify-player

skill (requires OAuth setup).