Check if Spotify authentication is set up and working.

Returns current user info if authenticated.

Get your top artists based on listening history.

Great for understanding your music taste and finding festival lineups.

Get your top tracks based on listening history.

Get your recently played tracks.

Get all artists you follow on Spotify.

Get all your liked/saved songs on Spotify.

Note: This may take 1-2 minutes for large libraries (10k songs).

Get unique artists from your saved songs, sorted by song count.

This shows artists you have saved songs from (even if not followed), ranked by how many songs you've saved.

Find albums where you have N or more saved songs.

Great for finding albums worth buying on vinyl!

Export a complete summary of your Spotify library.

Includes:

• Followed artists

• Top artists by saved song count

• Albums with most saved songs

Follow artists on Spotify.

Unfollow artists on Spotify.

For safety, returns a preview unless confirm=True.

Save tracks to your Spotify library (like/heart them).

Remove tracks from your Spotify library.

For safety, returns a preview unless confirm=True.

Search for a single track and get matches with confidence scores.

Broader fuzzy search when exact match fails.

Tries multiple strategies:

1. Exact title + artist

2. Title only

3. Simplified title (removing parentheses, etc.)

Search for multiple tracks with confidence scoring.

Categorizes results:

• HIGH (>= 90%): Safe to auto-add

• MEDIUM (70-89%): Should review

• LOW (< 70%): Needs attention

• NOT FOUND: No results

Get the 30-second preview URL for a track.

Create a new Spotify playlist.

Add tracks to an existing playlist.

Handles batching automatically (Spotify max 100 per request).

Create a playlist from batch search results.

Full workflow: Parse song list CSV, search all tracks, create playlist.

This is the main tool for bulk playlist creation from a list of songs.

Add tracks from a reviewed CSV to an existing playlist.

Use this after reviewing uncertain matches from a batch search.

The CSV should have an 'action' column:

• 'approve': Add the matched track

• 'reject': Skip this track

• spotify:track:xxx: Use this specific URI instead

Get information about a playlist.

Update playlist details (name, description, public status).

Only provide the fields you want to change.

Get all tracks from a playlist.

Export a playlist to CSV format.

Great for backing up playlists or sharing song lists.

Compare two playlists to find shared and unique tracks.

Find duplicate tracks in a playlist.

Remove duplicate tracks from a playlist, keeping the first occurrence.

For safety, returns a preview unless confirm=True.

Remove specific tracks from a playlist.

For safety, returns a preview unless confirm=True.

Move tracks within a playlist.

Parse a CSV of songs into a structured list.

Use this to validate your CSV before batch searching.

Export medium/low confidence matches to a CSV for human review.