spotify-history

Fetch Spotify listening history and generate personalized music recommendations.

Updated Oct 26, 2025
One-click install
npx skills add https://github.com/currentsuspect/currentsuspect --skill spotify-history
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotify-history
Source: https://github.com/currentsuspect/currentsuspect/tree/main/skills/spotify-history
Command: npx skills add https://github.com/currentsuspect/currentsuspect --skill spotify-history

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, spotipy, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of manually tracking and discovering music on Spotify by providing an automated way to access your listening history, top artists/tracks, and personalized recommendations.

Core Features & Use Cases

  • Listening History: Retrieve your recent tracks, artists, and playback information.
  • Top Artists/Tracks: Access your most-played artists and tracks across different time frames.
  • Recommendations: Get personalized music recommendations based on your listening habits.
  • Auto-Refresh: Tokens refresh automatically, ensuring continuous access to your Spotify data.

Quick Start

Run the setup wizard to authenticate your Spotify account and start using the skill.

Frequently Asked Questions about spotify-history

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get my Spotify listening history and top artists?

To get your Spotify listening history, this Skill fetches your recent tracks, top artists, and playback information automatically using the Spotify API. It requires OAuth authentication to securely retrieve your personal user data.

Can I get personalized music recommendations based on my Spotify history?

Yes, you can get personalized music recommendations based on your Spotify history. The Skill analyzes your listening habits and most-played tracks across different time frames to generate tailored track and artist suggestions.

Do I need Spotify API access to retrieve my top tracks?

Yes, you need Spotify API access and OAuth authentication to retrieve your top tracks. The Skill uses the spotipy library to handle token retrieval, which refreshes automatically to ensure continuous access to your data.

What's the best way to automate tracking my Spotify listening habits?

The best way to automate tracking Spotify listening habits is running the setup wizard to authenticate your account. Once configured, the Skill continuously retrieves your top artists and recent tracks without manual tracking.

Why does my Spotify API access expire when fetching listening history?

Spotify API access expires due to OAuth token limitations, but this Skill handles it automatically. Tokens refresh automatically during your listening history retrieval, ensuring continuous access without manual re-authentication.

Are there limitations to the Spotify data I can analyze?

Limitations of analyzing Spotify data include relying strictly on the Spotify API and OAuth authentication scope. You can access your recent tracks and top artists across different time frames, but only within the bounds of your authorized user data.