Check Spotify connection status, profile info, and current playback.

Get the currently playing track, playback state, and device info.

Start or resume playback of a track URI, album/playlist context_uri, or just resume if neither given.

Pause the current playback.

Resume paused playback.

Skip to the next track.

Skip to the previous track.

Add a track or episode URI to the playback queue.

Get the current playback queue (now playing + upcoming tracks).

List all available Spotify Connect devices.

Set playback volume (0-100). Requires Premium.

Seek to a position (in milliseconds) in the currently playing track. Requires Premium.

Set repeat mode: off, context, or track. Requires Premium.

Turn shuffle on or off. Requires Premium.

Transfer playback to a different device. Requires Premium.

List your playlists (up to 50).

Get playlist details and its first page of tracks.

Get tracks from a playlist with pagination (limit up to 100, offset for paging).

Create a new empty playlist with the given name.

Add track URIs to a playlist (max 100 per call). Appends by default or inserts at position.

Move tracks within a playlist (range_start to insert_before, range_length consecutive).

Update a playlist's name, description, or public/private visibility.

Follow a playlist.

Get a playlist's cover image URLs.

Check if specific users follow a playlist (max 5 user IDs).

Search Spotify for tracks, artists, albums, or playlists. Supports field filters like artist:, genre:, year: in the query.

Get up to 20 artists similar to a given artist.

Discover tracks from an artist's related artists' recent albums (1-50).

Discover tracks by mood (happy, sad, energetic, chill, focused, romantic, angry, party).

Explore a genre by finding its tracks and artists.

Find an artist's deep cuts -- album tracks that were not released as singles.

Get your top tracks by time range (short_term/medium_term/long_term), up to 50.

Get your top artists by time range (short_term/medium_term/long_term), up to 50.

Get your recently played tracks in reverse chronological order, up to 50.

Get your liked/saved tracks with pagination (limit up to 50, offset for paging).

Save tracks to your Liked Songs (max 50 URIs per call).

Get your saved albums with pagination (limit up to 50, offset for paging).

Save albums to your library (max 50 per call).

Check which tracks are in your Liked Songs (max 50 per call).

Check which albums are saved in your library (max 50 per call).

Get your saved podcast episodes (up to 50).

Follow one or more artists (max 50 per call).

Get your followed artists (up to 50).

Check if you follow specific artists (max 50 per call).

Check if you follow specific Spotify users.

Follow one or more Spotify users.

Get your saved/followed podcasts and shows (up to 50).

Get detailed information about a podcast or show.

Get episodes of a show, newest first (up to 50).

Save shows to your library (max 50 per call).

Check which shows are saved in your library (max 50 per call).

Save podcast episodes to your library (max 50 per call).

Get detailed information about a podcast episode.

Get detailed information about a track.

Get detailed information about an album including its tracklist.

Get detailed information about an artist.

Get a Spotify user's public profile and public playlists.

List all albums, singles, and compilations for an artist.

Find and optionally remove duplicate tracks from a playlist. Set dry_run=False to remove.

Merge multiple playlists into one new playlist, removing duplicates by default.

Split a playlist into per-artist sub-playlists. Artists with fewer than 3 tracks go into a "Various" playlist.

Compare two playlists, showing tracks unique to each and tracks they share.

Export a playlist as a formatted text list with artist, album, and duration for each track.

Scan all your playlists and find which pairs share tracks, ranked by overlap.

Scan all your playlists and find ones where one playlist is a near-subset of another. Threshold is the percentage of the smaller playlist's tracks that must exist in the larger.

Merge unique tracks from a source playlist into a target playlist. Tracks already in target are skipped. Set dry_run=False to apply.

Generate a listening report combining top tracks, top artists, genre breakdown, and recent activity.

Analyze a playlist's composition including top artists, genre distribution, decades, and duration.

Compare your top artists and genres across short, medium, and long term to identify taste trends.

Reorder a playlist using a smart strategy: variety, alphabetical_artist, chronological, genre_variety, energy_arc, or reverse_chronological.

Get a comprehensive artist profile including genres, full discography, and related artists.

Create a radio-style playlist from a seed track or artist by sampling related artists' catalogs.

Snapshot your current top tracks into a private playlist as a musical time capsule.

Create a playlist matching a mood (happy, sad, energetic, chill, focused, romantic, angry, party).

Create a playlist of tracks from a specific decade (1960s through 2020s).

Sort a playlist by track_name, artist_name, album_name, duration, or date_added.

Find and optionally remove unavailable and duplicate tracks from a playlist. Set dry_run=False to apply.

Create a new playlist by round-robin interleaving tracks from 2-5 source playlists.

Generate a radio playlist from an existing playlist's top artists and their related artists, excluding existing tracks.

Add multiple tracks (max 50) to the playback queue in order. Requires an active device.

Queue tracks from a playlist, optionally shuffled. Requires an active device.

Analyze a playlist's vibe, energy, and genre makeup using artist genre data.

Find tracks that match a playlist's vibe by searching its top genres, excluding existing tracks.

Analyze recent listening patterns: time-of-day, day-of-week, sessions, and repeat plays.

Build a genre taste profile with diversity score and niche artist detection from your top artists.

Compare 2-5 playlists side by side: shared tracks, shared artists, unique tracks, and size/duration.

Scan all your playlists and show when each was last updated, sorted by staleness (oldest first).

Map an artist's full release timeline grouped by year, with career span and release type counts.

Map an artist's network of related artists. Depth 2 reveals bridge artists connecting different parts of the network.

Find songs using a natural-language description. Parses quoted titles, "by artist", decade refs, and genre keywords.

Sync your Spotify library to a local index for AI-powered playlist curation.

Fetches all liked songs and tracks from playlists you created (skips followed/saved playlists by others). Run periodically to keep fresh.

Args: include_liked: Sync liked/saved songs. Default True. include_playlists: Sync your created playlists. Default True. force: Re-sync even if synced recently. Default False.

Get a summary of your synced library — artist counts, playlist names, and dates.

Returns your full artist landscape (compact) so the AI can reason about vibes, genres, and groupings without loading every track.

Query your synced library with filters. Returns matching tracks with URIs.

All filters are combined with AND logic. All text matching is case-insensitive and supports partial matches.

Args: artists: Filter by artist names (partial match, case-insensitive). playlist_name: Filter to tracks from a specific playlist (partial match). added_after: Only tracks added after this date (YYYY-MM-DD). added_before: Only tracks added before this date (YYYY-MM-DD). source: "liked", "playlists", or "all" (default "all"). track_name: Filter by track name (partial match). album_name: Filter by album name (partial match). limit: Max results (default 200, max 500).