Spotify Player Skill: Terminal Spotify Control for AI Agents and Power Users

15,152+ downloads and 33 stars on ClawHub. The spotify-player skill by @steipete (Peter Steinberger, OpenClaw's founder) brings Spotify control into the terminal — and into your AI agent's reach. Search tracks, control playback, switch devices, and manage queues without touching the Spotify app. Requires Spotify Premium.

The Problem It Solves

Every developer who's spent hours in a terminal knows the friction: you want to skip a track or search for something to focus on, but switching to the Spotify app breaks your flow. Worse, if you're building an AI agent that needs to control music as part of a larger workflow — a focus session manager, a smart home assistant, a mood-based playlist bot — there's no clean programmatic interface that works from the command line.

The spotify-player skill solves both: one command to skip a track from the terminal, and a clean interface for AI agents to drive Spotify as part of automated workflows.

Two Backends, One Interface

The skill supports two CLI backends. spogo is the preferred choice:

The SKILL.md instructs the agent to try spogo first and fall back to spotify_player if needed.

Installation

# Install via ClawHub
clawhub install spotify-player
 
# Install the preferred backend
brew tap steipete/tap
brew install spogo
 
# Set up authentication (import cookies from Chrome)
spogo auth import --browser chrome

For spotify_player fallback:

brew install spotify_player
# Configure client_id in ~/.config/spotify-player/app.toml for Spotify Connect

Core Commands

Playback Control

spogo play
spogo pause
spogo next
spogo prev
 
# Check current status
spogo status

Search

# Search for a track
spogo search track "lofi hip hop"
 
# Search and play immediately (AI workflow pattern)
spogo search track "focus music" && spogo play

Device Management

# List available Spotify Connect devices
spogo device list
 
# Switch playback to a specific device
spogo device set "Living Room Speaker"
spogo device set "MacBook Pro"

This makes it practical for home automation and multi-device setups — an agent can redirect playback from your laptop to a speaker when you walk into a room.

spotify_player Fallback Commands

spotify_player search "morning playlist"
spotify_player playback play
spotify_player playback pause
spotify_player playback next
spotify_player playback previous
spotify_player connect
spotify_player like

The TUI (terminal UI) mode is also available — press ? for keyboard shortcuts when running spotify_player interactively.

AI Agent Workflow Examples

Focus session manager: An agent monitors your calendar, starts a Pomodoro timer, and controls music automatically:

# Start a focus session
spogo search track "binaural beats focus" && spogo play
spogo device set "Desk Speaker"
# ... 25 minutes later ...
spogo pause

Mood-based playlist: An agent reads time of day, weather, or task type and sets appropriate music:

# Morning workflow
spogo search track "morning jazz"
spogo play
 
# Deep work mode
spogo search track "ambient electronic focus"
spogo play

Smart home integration: Trigger via cron or home automation events:

# On arrival home (via geofencing trigger)
spogo device set "Home Speaker"
spogo search track "evening chill"
spogo play

Considerations

• Spotify Premium required — free accounts don't support playback control via the API. This is a Spotify restriction, not a skill limitation.
• Cookie-based auth (spogo) — spogo auth import --browser chrome reads cookies from your browser. This works but requires re-importing if cookies expire.
• Spotify Dev Mode limit (Feb 2026): Spotify restricted Developer Mode apps to 5 authorized users. The spogo/spotify_player tools use their own registered app credentials, so this limit typically doesn't affect personal use.
• macOS/Linux focus: Both spogo and spotify_player install via Homebrew. Windows users need WSL or alternative installation methods.
• Network required: Both backends require an active network connection to communicate with Spotify's API. Offline playback via the Spotify app cannot be controlled this way.

Comparison: Skill vs. Spotify App vs. MCP Servers

The skill is optimized for quick playback control in an OpenClaw context. For full playlist management and advanced features, the broader MCP Spotify ecosystem offers more capability at the cost of additional setup.

The Bigger Picture

spotify-player is a small skill with outsized quality-of-life impact. The fact that steipete — OpenClaw's own founder — shipped this skill says something: the best AI assistant isn't one that can only do productive work. It's one that integrates seamlessly into your environment, including the music you listen to while you work.

As AI agents take on more ambient automation tasks (focus sessions, meeting prep, end-of-day wind-down), music control becomes a natural part of the workflow surface. This skill is the entry point for that.

View the skill on ClawHub: spotify-player