spotify-privacy Connector for AI agents.
1 live capability
Analyze your personal music trends and listening habits from exported data.
Waiting for input…
Why people use spotify-privacy
Spotify Listening History Parser Music Trend Analysis
This Connector changes the workflow. You just point your AI client at the file and start asking questions. It parses the data locally and gives you a clear summary of your top tracks and total listening hours instantly. You get the answers you want without the manual labor.
What Vinkius changes
You get a clean music profile from a messy data dump without touching a spreadsheet.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
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.
- Real-world use case 02
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.
- Real-world use case 03
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.
Complete set · 1capability
The complete spotify-privacy capability set.
These are the exact actions your AI can choose when you ask it to work with spotify-privacy.
01
1 capability in this set.
Part of 1 available through spotify-privacy.
- 01 Capability
Parse spotify history
This capability reads your Spotify data export to aggregate your top artists and tracks. It also calculates your total listening time and unique play counts.
Set up in minutes
One URL. Then ask spotify-privacy to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use spotify-privacy from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it spotify-privacy, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable spotify-privacy for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the spotify-privacy URL.
- Step 03
Save and start
Save the connection and enable spotify-privacy in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"spotify-listening-history-parser": {
"url": "https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using spotify-privacy
Open Agent mode in chat and ask: "Using spotify-privacy, help me...". 1 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"spotify-listening-history-parser": {
"url": "https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using spotify-privacy
Ask Copilot: "Using spotify-privacy, help me...". 1 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"spotify-listening-history-parser": {
"url": "https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using spotify-privacy
Open Cascade and ask: "Using spotify-privacy, help me...". 1 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"spotify-listening-history-parser": {
"url": "https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using spotify-privacy
Ask Cline: "Using spotify-privacy, help me...". 1 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add spotify-listening-history-parser --transport http "https://edge.vinkius.com/vk_preview_SZcwckYRckPicpg8UyHeMbWZDomWQEWPEcit1eOB/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using spotify-privacy
Ask Claude: "Using spotify-privacy, show me...". 1 tools are ready
Where the request belongs
Work spotify-privacy can move forward.
Music enthusiasts and data hobbyists who are tired of scrolling through thousands of lines of text to find their own stats. It's for the person who wants to know their all-time top tracks without building a custom database.
Music Blogger
Researching trends for a retrospective article about a specific year or artist.
Data Hobbyist
Analyzing personal consumption habits to see how their tastes have evolved over time.
Content Creator
Finding hidden gems in their own history to share with their audience in a video.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsLast.fm
Manage your music profile. audit listening habits, top tracks, and artists via AI.
Audiomack Music
Explore and discover music via Audiomack. search for songs, albums, and trending artists directly from any AI agent.
Spotify Music
Control playback, search library, get audio features, and manage playlists via Spotify API.
TIDAL Developer API
Access music data. audit albums, artists, and tracks via AI.
Deezer
Search music, browse artists, albums and playlists, and explore charts via AI.
Audiomack
Stream and discover music via Audiomack. search tracks, manage playlists, and follow artists directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep spotify-privacy connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about spotify-privacy.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to spotify-privacy.
Connect spotify-privacy once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available