playlist-curator — Claude Code plugin: what it does, how to install
Gives Claude Code the ability to assemble Spotify playlists via audio feature matching, cross-artist aesthetic fusions, and persistent taste preferences.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install playlist-curator@claude-communityWhat playlist-curator does
This plugin equips the coding assistant with acoustic reasoning capabilities. Instead of relying solely on basic catalog lookups, it parses dimensions such as valence, danceability, acousticness, and tempo. The assistant can merge distinct artist profiles using target zones and store user constraints across separate terminal sessions.
Track generation runs through a three-stage fallback structure. It checks ReccoBeats first, drops down to direct audio metric evaluation when needed, and relies on Spotify search paired with MusicBrainz genre data as a final resort. Every track suggestion carries explicit scores detailing why it matches.
A configured Spotify Developer app alongside Python 3.9+ is mandatory. Without placing SPOTIPY_CLIENT_ID and SPOTIPY_CLIENT_SECRET into .env and completing OAuth via http://127.0.0.1:8888/callback, the assistant cannot manage your playlists.
What it helps with
- generate a cohesive playlist blending two contrasting artist styles
- extract high-tempo tracks from recent listening sessions for workouts
- pull obscure album tracks from chosen bands without mainstream hits
- purge specific artists from a playlist while replenishing matching sounds
Example prompts for the agent
- Make a 50-minute playlist merging the vibes of Radiohead and Mitski, excluding their biggest hits.
- Look up my recent listening log on Spotify and pick upbeat tracks suited for a run.
- Take my chill evening playlist, remove all tracks by Drake, and add similar acoustic songs.
How to install playlist-curator
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install playlist-curator@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about playlist-curator
How do I install playlist-curator in Claude Code?
Register the marketplace repository with /plugin marketplace add anthropics/claude-plugins-community, then install the package by running /plugin install playlist-curator@claude-community.
What external dependencies are required?
You need Python 3.9+ and a registered Spotify Developer app. Add your client credentials to .env with redirect URI set to http://127.0.0.1:8888/callback, then execute .venv/bin/python scripts/spotify_auth.py.
How does the recommendation system handle API outages?
The engine relies on a three-tier fallback mechanism. When ReccoBeats fails, it scores tracks by audio features directly, ultimately falling back to Spotify catalog search and MusicBrainz tags.
