Agent skill · marketing growth · sundial-org
spotify-history
Access Spotify listening history, top artists/tracks, and get personalized recommendations via the Spotify Web API. Use when fetching a user's recent plays, analyzing music taste, or generating recommendations. Requires one-time OAuth setup.
Why this skill is useful
Adds executable scripts for accessing Spotify API endpoints that provide personalized music recommendations and user listening history.
What it needs
Requires python3 installed locally. Requires spotify account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Spotify History & Recommendations Access Spotify listening history and get personalized recommendations. Setup (One-Time) Quick Setup (Recommended) Run the setup wizard: This guides you through: 1. Creating a Spotify Developer App 2. Saving credentials securely 3. Authorizing access Manual Setup 1. Create Spotify Developer App Go to developer.spotify.com/dashboard Click Create App Fill in: App name: Clawd (or any name) App description: Personal assistant integration Redirect URI: http://127.0.0.1:8888/callback ⚠️ Use exact URL! Save and copy Client ID and Client Secret 2. Store Credentials Option A: Credentials file (recommended) Option B: Environment variables 3. Authenticate With browser (local machine): Headless (no browser): Follow the prompts to authorize via URL and paste the callback. Tokens are saved to ~/.config/spotify-clawd/token.json and auto-refresh when expired. Usage Command Line Time Ranges shortterm — approximately last 4 weeks mediumterm — approximately last 6 months (default) longterm — all time Example Output Agent Usage When user asks about music: "What have I been listening to?" → spotify-api.py recent "Who are my top artists?" → spotify-api.py top-artists "Recommend new music" → spotify-api.py recommend + add your own knowledge For recommendations, combine API data with music knowledge to suggest similar artists not in their library. Troubleshooting "Spotify credentials not found!" Make sure credentials/spotify.json exists or environment variables are set Credential file is checked first, then env vars Run bash skills/spotify-history/scripts/setup.sh to create credentials "Not authenticated. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/spotify-history