ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified media Safety 4/5

spotify-web-api

Spotify control via Web API - playback, history, top tracks, search. Cross-platform (no Mac required).

Why use this skill?

Integrate Spotify into OpenClaw with this cross-platform skill. Manage playback, view listening history, and analyze your top tracks effortlessly.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/mvanhorn/spotify-web-api
Or

What This Skill Does

The spotify-web-api skill provides a robust interface for interacting with Spotify directly through your AI assistant. Unlike desktop-bound scripts that rely on operating system events, this skill utilizes the official Spotify Web API, making it completely cross-platform. It allows users to query their personal listening history, view analytics regarding their top artists and tracks, and maintain full playback control without ever leaving the terminal or the AI chat interface. By leveraging OAuth authentication, it provides a secure way to bridge your Spotify account with OpenClaw, enabling hands-free control of your media consumption.

Installation

To integrate this skill, use the following command in your terminal: clawhub install openclaw/skills/skills/mvanhorn/spotify-web-api. After installation, navigate to the Spotify Developer Dashboard to create a new application, noting your Client ID and Client Secret, and setting the redirect URI to http://localhost:8888/callback. Export these credentials as environment variables (SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET). Finally, run python3 {baseDir}/scripts/spotify.py auth to initiate the OAuth handshake; a browser window will open to grant the necessary permissions, and your session will be cached locally in ~/.spotify_cache.json for subsequent usage.

Use Cases

This skill is perfect for power users who want to integrate music control into their productivity workflow. Use it to check your music metrics, such as identifying your top-played tracks over the last month, or to quickly switch playback devices when moving between your desk and home speakers. It is especially useful for maintaining focus during deep work, as you can command the AI to play specific songs or search for new artists without the distraction of switching windows to the Spotify application.

Example Prompts

  1. "What are my top tracks this month?"
  2. "Play some Daft Punk on my living room speakers."
  3. "Pause the music and tell me what I was listening to earlier today."

Tips & Limitations

Please note that full playback control requires a Spotify Premium subscription. Free accounts are limited to read-only operations such as viewing history and retrieving top stats. Ensure that your Spotify client is active on at least one device, or the API may fail to find a target for playback commands. Regularly check the developer dashboard if you encounter connection issues, as token scopes may occasionally require manual refreshing.

Metadata

Author@mvanhorn
Stars1335
Views4
Updated2026-02-23
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-mvanhorn-spotify-web-api": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#spotify#music#audio#automation#api
Safety Score: 4/5

Flags: network-access, file-read, file-write, external-api