spotify-history

✓Verified·Scanned 2/17/2026

The skill accesses a user's Spotify listening history and provides top artists/tracks and recommendations via the Spotify Web API. It requires SPOTIFY_CLIENT_ID/SPOTIFY_CLIENT_SECRET, stores credentials in credentials/spotify.json and tokens in ~/.config/spotify-clawd/token.json, runs bash skills/spotify-history/scripts/setup.sh, and calls https://accounts.spotify.com and https://api.spotify.com/v1.

from clawhub.ai·v6f30c28·16.6 KB·0 installs
Scanned from 1.1.0 at 6f30c28 · Transparency log ↗
$ vett add clawhub.ai/braydoncoyer/spotify-history

Spotify History & Recommendations

Access your Spotify listening history, top artists/tracks, and get personalized recommendations via the Spotify Web API.

Quick Start

# Run setup wizard
bash skills/spotify-history/scripts/setup.sh

# Test it
python3 scripts/spotify-api.py recent
python3 scripts/spotify-api.py top-artists
python3 scripts/spotify-api.py recommend

What It Does

  • Listening History: See what you've been playing recently
  • Top Artists/Tracks: Your most-played artists and tracks (4 weeks, 6 months, or all time)
  • Recommendations: Get personalized music recommendations based on your taste
  • Auto-Refresh: Tokens refresh automatically - set up once, works forever

Requirements

  • Python 3.6+
  • Spotify account (free or premium)
  • One-time setup: Spotify Developer App (free, takes 2 minutes)

Agent Integration

When you ask your agent about music:

  • "What have I been listening to?"
  • "Who are my top artists?"
  • "Recommend new music"

The agent will:

  1. Fetch your Spotify data
  2. Analyze your taste
  3. Combine API data with music knowledge for personalized recommendations

Documentation

See SKILL.md for full documentation, troubleshooting, and advanced usage.

License

MIT