How do I install the Spotify Web API skill?

Run npx skillmds@latest add modbender/spotify-web-api 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.

What does the Spotify Web API skill do?

Spotify control via Web API - playback, history, top tracks, search. Cross-platform (no Mac required). It is listed under Integrations & APIs on SkillMD.

Is Spotify Web API 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 Web API?

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 Web API free to use?

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

Who published Spotify Web API?

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

Spotify Web API by modbender — Agent Skill

Name: Spotify Web API
Rating: 4.666666666666667 (3 reviews)
Author: modbender

File contents

Spotify Web API (Cross-Platform)

Control Spotify via Web API. Works from any platform — no Mac required.

Setup

1. Create Spotify App:

Go to https://developer.spotify.com/dashboard
Create a new app
Add redirect URI: http://localhost:8888/callback
Copy Client ID and Client Secret

2. Set Environment Variables:

export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret"

3. Authenticate:

python3 {baseDir}/scripts/spotify.py auth

Opens browser for OAuth. Token cached in ~/.spotify_cache.json.

Commands

# Currently playing
python3 {baseDir}/scripts/spotify.py now

# Recently played
python3 {baseDir}/scripts/spotify.py recent

# Top tracks/artists
python3 {baseDir}/scripts/spotify.py top tracks --period month
python3 {baseDir}/scripts/spotify.py top artists --period year

# Playback control
python3 {baseDir}/scripts/spotify.py play
python3 {baseDir}/scripts/spotify.py play "bohemian rhapsody"
python3 {baseDir}/scripts/spotify.py pause
python3 {baseDir}/scripts/spotify.py next
python3 {baseDir}/scripts/spotify.py prev

# Search
python3 {baseDir}/scripts/spotify.py search "daft punk"

# List devices
python3 {baseDir}/scripts/spotify.py devices

Example Chat Usage

"What am I listening to?"
"What have I listened to lately?"
"What are my top tracks this month?"
"Play Bohemian Rhapsody"
"Skip this song"
"Pause the music"

Requirements

Spotify Premium (for playback control)
Free accounts can still view history/top tracks

API Reference

Uses the Spotify Web API: https://developer.spotify.com/documentation/web-api

Frequently asked questions

Spotify Web API