Metadata-Version: 2.4
Name: spotify-analytics-mcp
Version: 0.1.2
Summary: MCP server and CLI installer for the Spotify AI Analytics project.
Project-URL: Homepage, https://github.com/wcnoname5/spotify-ai-analytics
Project-URL: Repository, https://github.com/wcnoname5/spotify-ai-analytics
Project-URL: Issues, https://github.com/wcnoname5/spotify-ai-analytics/issues
Author: WC Chang
License: MIT
License-File: LICENSE
Keywords: analytics,claude,cli,listening-history,mcp,spotify
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Requires-Dist: fastmcp>=2.0
Requires-Dist: platformdirs>=4.0
Requires-Dist: rich>=13.7
Requires-Dist: spotify-analytics-core>=0.1.0
Requires-Dist: spotify-analytics-dataloader>=0.1.0
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# spotify-analytics-mcp

An MCP server that connects Claude Desktop / Claude Code to your Spotify listening history — query your stats, control playback, and generate playlists through natural language.

Ships with a `spotify-mcp` CLI that walks you through Spotify app registration, OAuth login, history import, and Claude Desktop wiring.

## Quick Start

```bash
uvx --from spotify-analytics-mcp spotify-mcp setup
```

See [the project README](https://github.com/wcnoname5/spotify-ai-analytics#readme) for prerequisites and full setup instructions.

```bash
uvx --from spotify-analytics-mcp spotify-mcp --help
```
