spotify-playlist-generator — SKILL.md
Overview
Use this MCP server to generate Spotify playlists from a user-requested duration and mood/vibe. The primary response returns selected tracks with cover art URL, song name, duration, singers/artists, album, Spotify URI, and Spotify URL.
Tools
generate_spotify_playlist
Generates a Spotify playlist candidate list from duration_minutes and mood_vibe. Set create_playlist=true to create the playlist in the current user's Spotify account.
Parameters:
duration_minutes(number, required): target playlist duration, 5 to 480 minutes.mood_vibe(string, required): natural language vibe such asrainy indie,workout,chill focus, orlate-night drive.market(string, optional): two-letter Spotify market code; defaults toUS.playlist_name(string, optional): playlist name when creating it in Spotify.create_playlist(boolean, optional): create the playlist in Spotify.public(boolean, optional): make the created playlist public.
setup_spotify_oauth
Returns a Spotify authorization URL for playlist write scopes. Use this when the server does not yet have SPOTIFY_ACCESS_TOKEN or SPOTIFY_REFRESH_TOKEN.
exchange_spotify_code
Exchanges a Spotify OAuth callback code for access and refresh tokens. Store the returned refresh token in SPOTIFY_REFRESH_TOKEN.
Usage Patterns
- Preview only: call
generate_spotify_playlistwithduration_minutes,mood_vibe, and optionalmarket. - Create in Spotify: complete OAuth setup first, then call
generate_spotify_playlistwithcreate_playlist=true. - OAuth setup: call
setup_spotify_oauth, open the returned URL, then callexchange_spotify_codewith the callback code.
Gotchas
- Creating playlists requires a user OAuth token with
playlist-modify-privateorplaylist-modify-public. - Preview generation can use Spotify client credentials, but playlist creation cannot.
- Spotify market availability can change results; use the user's country if they ask for region-specific music.
- The server does not store secrets. Configure credentials with environment variables.
Source: Type-MCP/mcp-anything — distributed by TomeVault.