# Spotify Listening History Parser MCP for AI Agents AI Agent Connect

> Spotify Listening History Parser turns your messy Spotify data export into a clean summary of your music habits. It automatically identifies your top 30 artists and tracks while calculating your total listening hours. It's the fastest way to turn a massive data file into a readable music profile. Instead of digging through thousands of lines of text, you can just ask your AI client to summarize your favorite genres, your most-played tracks of all time, and your total time spent listening to music.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/ai-agent-connect
- **Tags:** data-parsing, music-analytics, listening-history, json-processing, personal-data, media-consumption

## Description

Spotify Listening History Parser turns your messy Spotify data export into a clean summary of your music habits. Most people who want to see their true music stats have to deal with a massive data file from Spotify's privacy settings. It's a wall of text that's impossible to read without a spreadsheet or some serious coding knowledge. This tool changes that by doing the heavy lifting for you. Instead of you digging through thousands of lines of data, you just point your AI client at that file. It handles the extraction, grouping your most-played tracks, and summing up your total time spent listening. You get a clean, organized look at your habits without ever having to open Excel or write a single line of code. It's a great way to see how your taste has evolved over years of listening. Since it runs locally on your machine, your data stays yours. You can find this in the Vinkius catalog to get started with your own music analysis. It turns a boring data export into a conversation about your favorite genres and artists. You can ask about specific years, find your most-played tracks of all time, or see how many total hours you've spent on the platform. It takes the friction out of personal data analysis and gives you a direct line to your own history.

## Tools

### parse_spotify_history
This tool reads your Spotify data export to aggregate your top artists and tracks. It also calculates your total listening time and unique play counts.

## Prompt Examples

**Prompt:** 
```
What was my most listened artist in 2024?
```

**Response:** 
```
Based on your 2024 history, your top artists were:

* **Radiohead** (342 plays)
* **Tame Impala** (218 plays)
* **Daft Punk** (195 plays)

You spent a significant amount of time with these three acts this year.
```

**Prompt:** 
```
How many total hours did I spend on Spotify?
```

**Response:** 
```
You spent a total of **1,245.3 hours** listening to music across **28,400** unique tracks. That is quite a deep dive into your library!
```

**Prompt:** 
```
Show my top 5 most played songs of all time.
```

**Response:** 
```
Here are your top 5 most-played tracks of all time:

| Rank | Track | Artist | Plays |
| :--- | :--- | :--- | :--- |
| 1 | Bohemian Rhapsody | Queen | 89 |
| 2 | Blinding Lights | The Weeknd | 76 |
| 3 | Creep | Radiohead | 71 |
| 4 | ... | ... | ... |
```

## Capabilities

### Extract top artists
Get a ranked list of your 30 most-played artists from your history.

### Identify top tracks
See which 30 songs you've played the most across your entire library.

### Calculate total hours
Get an exact count of your total listening time in hours.

### Count unique plays
See how many different songs you've actually listened to.

### Summarize listening habits
Ask your agent to summarize your music trends and favorites.

## Use Cases

### I want to see my top 10 artists from 2023.
The agent uses the parser to filter your history by year and identifies the most-played artists for that specific period.

### How many hours did I spend on music last year?
The agent calculates the total time spent listening from your data export to give you a specific yearly total.

### Who are my top 5 most played indie artists?
The agent filters your top artists list to find specific genres and identifies your most-played indie acts.

### Give me a summary of my most played songs.
The agent provides a formatted list of your top hits based on the aggregated data from your history.

## Benefits

- Skip the manual sorting. Use parse_spotify_history to jump straight to your top 30 artists without scrolling through thousands of lines of data.
- Keep your data private. This Connector processes your files locally on your own machine so your listening history is never uploaded to a third-party cloud.
- Get accurate time totals. The tool calculates your exact total listening hours across your entire history instead of you having to do the math.
- See your true favorites. It handles millions of plays to give you a clean ranking of your most-played tracks and artists.
- Get instant summaries. Ask your agent about your music trends and get a structured list of your favorite genres and artists in seconds.

## How It Works

The bottom line is you get a clean music profile from a messy data dump without touching a spreadsheet.

1. Request your data export from the Spotify Privacy settings page.
2. Provide the file path to your AI client using this Connector.
3. Ask your agent to summarize your top artists, tracks, or total hours.

## Frequently Asked Questions

**Can I use the Spotify Listening History Parser for my old data?**
Yes, this Connector parses the entire history included in your Spotify data export. As long as the data is in the export file, your AI agent can analyze it.

**Does the Spotify Listening History Parser work with Google Takeout?**
Yes, it works with the standard JSON exports provided by both Spotify's privacy settings and Google Takeout.

**Is my data safe with the Spotify Listening History Parser?**
Your data stays on your machine. The Connector reads the file locally and only sends the final summary to your AI client, keeping your raw history private.

**How do I get my data to use the Spotify Listening History Parser?**
Go to your Spotify account privacy settings and request a data export. Once you receive the JSON file, you can point your AI client to it.

**Can the Spotify Listening History Parser find my favorite genres?**
It can identify your most-played artists and tracks, which helps your agent summarize your favorite genres and overall music taste.

**Does the Spotify Listening History Parser handle millions of plays?**
Yes, it is designed to aggregate massive amounts of data to provide clean rankings of your top 30 artists and tracks.

**How do I get my Spotify data?**
Go to spotify.com/account/privacy. Request your data. Spotify emails you a download link within 30 days.

**Does it work with Apple Music?**
This parser is optimized for Spotify's JSON format. Apple Music exports use a different structure.

**Is my listening data sent to the cloud?**
No. All aggregation happens locally. Only the top-30 lists and totals are sent to the AI.