Leina 
Wanta 
Find Catalog Items
Search requested resource types and compare returned metadata.
/oo Spotify: Search Spotify for [query], types [types], market [market], and compare returned items.
Connect Spotify to Your AI Agent
Use AI with Spotify to search catalog items and review your top tracks or artists.
88 tools OAuth
Try a Spotify Task
Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.
oo Skill Spotify
Review Listening Preferences
Read your top tracks and artists over a selected time range.
/oo Spotify: Get my top tracks and artists for timeRange [range] and summarize the returned preferences.
Start Working with Spotify
-
Install OOMOL
Set up oo CLI and the oo Skill in your agent.
Install OOMOL → -
Connect Spotify
Connect through Spotify OAuth authorization.
Connect Spotify → -
Give Your Agent a Task
Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →
Choose Your Agent
- A Spotify account with permissions for the requested personal data.
- Catalog search requires query and resource types. Top-track and artist data use affinity time ranges rather than complete listening history.
Spotify Tools
Use AI with Spotify to search catalog items and review your top tracks or artists.
Find Catalog Items
Search requested resource types and compare returned metadata.
Review Listening Preferences
Read your top tracks and artists over a selected time range.
88 tools
Get Current User Profile
Get the current authenticated Spotify user's profile details.
spotify.get_current_user_profile Search Items
Search Spotify catalog content across one or more resource types with a keyword query.
spotify.search_items Get User Top Tracks
Get the current Spotify user's top tracks for a selected affinity time range.
spotify.get_user_top_tracks Get User Top Artists
Get the current Spotify user's top artists for a selected affinity time range.
spotify.get_user_top_artists Get Playlist
Get metadata for a Spotify playlist by its playlist ID.
spotify.get_playlist Get Playlist Items
Get playlist items for a Spotify playlist by its playlist ID.
spotify.get_playlist_items Get Album
Get a Spotify album by its album ID.
spotify.get_album Get Album Tracks
Get the tracks for a Spotify album by its album ID.
spotify.get_album_tracks Get Artist
Get a Spotify artist by its artist ID.
spotify.get_artist Get Artist Albums
Get Spotify albums for an artist by the artist ID.
spotify.get_artist_albums Get Artist Related Artists
Get related Spotify artists for an artist ID.
spotify.get_artist_related_artists Get Artist Top Tracks
Get top Spotify tracks for an artist ID in a given market.
spotify.get_artist_top_tracks Get Track
Get a Spotify track by its track ID.
spotify.get_track Get Several Tracks
Get multiple Spotify tracks by track ID.
spotify.get_several_tracks Get Several Artists
Get multiple Spotify artists by artist ID.
spotify.get_several_artists Get Several Albums
Get multiple Spotify albums by album ID.
spotify.get_several_albums Get Track Audio Features
Get Spotify audio features for a track ID.
spotify.get_track_audio_features Get Several Track Audio Features
Get Spotify audio features for multiple track IDs.
spotify.get_several_track_audio_features Get Track Audio Analysis
Get Spotify audio analysis for a track ID.
spotify.get_track_audio_analysis Get Recommendations
Get Spotify track recommendations from seed artists, tracks, or genres.
spotify.get_recommendations Get Available Genre Seeds
Get the genre seeds supported by Spotify recommendations.
spotify.get_available_genre_seeds Get Available Markets
Get the markets supported by Spotify catalog APIs.
spotify.get_available_markets Get Playlist Cover Image
Get Spotify cover images for a playlist ID.
spotify.get_playlist_cover_image Create Playlist
Create a Spotify playlist for a user account owned by the authenticated user.
spotify.create_playlist Change Playlist Details
Update Spotify playlist metadata such as name, description, visibility, or collaborative state.
spotify.change_playlist_details Add Items To Playlist
Add tracks or episodes to a Spotify playlist in the requested order.
spotify.add_items_to_playlist Update Playlist Items
Replace all items in a Spotify playlist or reorder an existing range of items.
spotify.update_playlist_items Remove Playlist Items
Remove tracks or episodes from a Spotify playlist.
spotify.remove_playlist_items Follow Playlist
Follow a Spotify playlist on behalf of the authenticated user.
spotify.follow_playlist Unfollow Playlist
Unfollow a Spotify playlist on behalf of the authenticated user.
spotify.unfollow_playlist Get Show
Get a Spotify show by its show ID.
spotify.get_show Get Show Episodes
Get Spotify episodes for a show ID.
spotify.get_show_episodes Get Episode
Get a Spotify episode by its episode ID.
spotify.get_episode Get Several Episodes
Get multiple Spotify episodes by episode ID.
spotify.get_several_episodes Get Audiobook
Get a Spotify audiobook by its audiobook ID.
spotify.get_audiobook Get Audiobook Chapters
Get Spotify chapters for an audiobook ID.
spotify.get_audiobook_chapters Get Chapter
Get a Spotify chapter by its chapter ID.
spotify.get_chapter Get Several Audiobooks
Get multiple Spotify audiobooks by audiobook ID.
spotify.get_several_audiobooks Get Several Chapters
Get multiple Spotify chapters by chapter ID.
spotify.get_several_chapters Get Several Shows
Get multiple Spotify shows by show ID.
spotify.get_several_shows Get Featured Playlists
Get Spotify featured playlists for a market and locale.
spotify.get_featured_playlists Get New Releases
Get Spotify new release albums for a market.
spotify.get_new_releases Get Browse Categories
Get Spotify browse categories for a market and locale.
spotify.get_browse_categories Get Browse Category
Get a Spotify browse category by category ID.
spotify.get_browse_category Get Category Playlists
Get Spotify playlists for a browse category ID.
spotify.get_category_playlists Get User Profile
Get a Spotify user profile by Spotify user ID.
spotify.get_user_profile Get Current User Playlists
Get playlists for the current authenticated Spotify user.
spotify.get_current_user_playlists Get User Playlists
Get playlists visible for a Spotify user ID.
spotify.get_user_playlists Save Albums For Current User
Save one or more Spotify albums to the authenticated user's library.
spotify.save_albums_for_current_user Remove Users Saved Albums
Remove one or more Spotify albums from the authenticated user's library.
spotify.remove_users_saved_albums Save Audiobooks For Current User
Save one or more Spotify audiobooks to the authenticated user's library.
spotify.save_audiobooks_for_current_user Remove User S Saved Audiobooks
Remove one or more Spotify audiobooks from the authenticated user's library.
spotify.remove_user_s_saved_audiobooks Save Episodes For Current User
Save one or more Spotify episodes to the authenticated user's library.
spotify.save_episodes_for_current_user Remove User S Saved Episodes
Remove one or more Spotify episodes from the authenticated user's library.
spotify.remove_user_s_saved_episodes Save Shows For Current User
Save one or more Spotify shows to the authenticated user's library.
spotify.save_shows_for_current_user Remove User S Saved Shows
Remove one or more Spotify shows from the authenticated user's library.
spotify.remove_user_s_saved_shows Save Tracks For Current User
Save one or more Spotify tracks to the authenticated user's library.
spotify.save_tracks_for_current_user Remove User S Saved Tracks
Remove one or more Spotify tracks from the authenticated user's library.
spotify.remove_user_s_saved_tracks Get User Saved Albums
Get albums saved by the current authenticated Spotify user.
spotify.get_user_saved_albums Get User Saved Audiobooks
Get audiobooks saved by the current authenticated Spotify user.
spotify.get_user_saved_audiobooks Get User Saved Episodes
Get episodes saved by the current authenticated Spotify user.
spotify.get_user_saved_episodes Get User Saved Shows
Get shows saved by the current authenticated Spotify user.
spotify.get_user_saved_shows Get User Saved Tracks
Get tracks saved by the current authenticated Spotify user.
spotify.get_user_saved_tracks Check Saved Albums
Check whether the current authenticated Spotify user has saved the given albums.
spotify.check_saved_albums Check Saved Audiobooks
Check whether the current authenticated Spotify user has saved the given audiobooks.
spotify.check_saved_audiobooks Check Saved Episodes
Check whether the current authenticated Spotify user has saved the given episodes.
spotify.check_saved_episodes Check Saved Shows
Check whether the current authenticated Spotify user has saved the given shows.
spotify.check_saved_shows Check Saved Tracks
Check whether the current authenticated Spotify user has saved the given tracks.
spotify.check_saved_tracks Follow Artists Or Users
Follow one or more Spotify artists or users on behalf of the authenticated user.
spotify.follow_artists_or_users Unfollow Artists Or Users
Unfollow one or more Spotify artists or users on behalf of the authenticated user.
spotify.unfollow_artists_or_users Get Followed Artists
Get artists followed by the current authenticated Spotify user.
spotify.get_followed_artists Check User Follows Artists Or Users
Check whether the current authenticated Spotify user follows the given artists or users.
spotify.check_user_follows_artists_or_users Check Users Follow Playlist
Check whether the given Spotify users follow a playlist.
spotify.check_users_follow_playlist Get Available Devices
Get available Spotify playback devices for the current authenticated user.
spotify.get_available_devices Start Resume Playback
Start a new Spotify playback context or resume playback on the targeted device.
spotify.start_resume_playback Pause Playback
Pause Spotify playback on the targeted device or current active device.
spotify.pause_playback Seek To Position
Seek the currently playing Spotify item to the given playback position.
spotify.seek_to_position Set Repeat Mode
Set Spotify repeat mode for the targeted playback device.
spotify.set_repeat_mode Set Playback Volume
Set Spotify playback volume for the targeted playback device.
spotify.set_playback_volume Skip To Next
Skip to the next item in the Spotify playback queue.
spotify.skip_to_next Skip To Previous
Skip to the previous item in the Spotify playback queue.
spotify.skip_to_previous Toggle Playback Shuffle
Enable or disable Spotify playback shuffle on the targeted device.
spotify.toggle_playback_shuffle Transfer Playback
Transfer Spotify playback to another available device.
spotify.transfer_playback Add Item To Playback Queue
Add a Spotify track or episode to the end of the playback queue.
spotify.add_item_to_playback_queue Get Playback State
Get the current Spotify playback state for the authenticated user.
spotify.get_playback_state Get Currently Playing Track
Get the currently playing Spotify item for the authenticated user.
spotify.get_currently_playing_track Get Recently Played Tracks
Get recently played Spotify tracks for the authenticated user.
spotify.get_recently_played_tracks Get User Queue
Get the current Spotify queue for the authenticated user.
spotify.get_user_queue No matching tools.
Frequently Asked Questions
Are top tracks a complete play history?
No. They reflect affinity for the selected time range.
Which catalog types should I supply?
Choose the resource types supported by search_items, such as tracks or artists, in its types input.
What should I specify in my request?
Catalog search requires query and resource types. Top-track and artist data use affinity time ranges rather than complete listening history.