How do AI agents use Spotify through Open Connector?

Your user connects Spotify once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Spotify tools to your agent over MCP or a typed API, with credentials injected server-side on each call.

Is this a Spotify MCP server?

Yes. Open Connector can serve Spotify as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Spotify actions with credentials injected server-side.

Where do Spotify credentials live?

In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Spotify integration

Spotify integration for AI agents.

Spotify integration for AI agents with secure authentication and server-side credential injection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Spotify tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.

View source on GitHub All integrations →

What your agents can do

Real Spotify actions, managed and audited.

Your user connects Spotify once; your agent can then read and manage Spotify Web API resources — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.

1
Your user grants Spotify access once (OAuth) — the token lands in the vault.
2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
3
Every routed call appends a hash-chained audit record — nothing leaves your infra.

Tools & triggers

Supported Spotify tools.

95 tools are generated from the published Spotify catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.

Showing 95 tools. All published catalog entries are included in this page's server-rendered HTML.

Add Items to Playlist: Add one or more items to a user's playlist.; PlaylistsTracks
Add Item to Playback Queue: Add an item to be played next in the user's current playback queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Add Items to Playlist [DEPRECATED]: **Deprecated:** Use [Add Items to Playlist](/documentation/web-api/reference/add-items-to-playlist) instead. Add one or more items to a user's playlist.; PlaylistsTracks
Change Playlist Details: Change a playlist's name and public/private state. (The user must, of course, own the playlist.); PlaylistsLibrary
Check If User Follows Artists or Users: Check to see if the current user is following one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; UsersArtistsLibrary
Check if Current User Follows Playlist: Check to see if the current user is following a specified playlist. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; UsersPlaylists
Check User's Saved Items: Check if one or more items are already saved in the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, artists, users, and playlists.; Library
Check User's Saved Albums: Check if one or more albums is already saved in the current Spotify user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; AlbumsLibrary
Check User's Saved Audiobooks: Check if one or more audiobooks are already saved in the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; AudiobooksLibrary
Check User's Saved Episodes: Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; EpisodesLibrary
Check User's Saved Shows: Check if one or more shows is already saved in the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; ShowsLibrary
Check User's Saved Tracks: Check if one or more tracks is already saved in the current Spotify user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.; TracksLibrary
Create Playlist: Create a playlist for the current Spotify user. (The playlist will be empty until you [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000 playlists.; PlaylistsLibrary
Create Playlist for user: **Deprecated**: Use [Create Playlist](/documentation/web-api/reference/create-playlist) instead. Create a playlist for a Spotify user. (The playlist will be empty until you [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000 playlists.; PlaylistsLibrary
Follow Artists or Users: Add the current user as a follower of one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; UsersArtistsLibrary
Follow Playlist: Add the current user as a follower of a playlist. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; UsersPlaylists
Get Category's Playlists: Get a list of Spotify playlists tagged with a particular category.; PlaylistsCategories
Get Single Browse Category: Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).; Categories
Get a Chapter: Get Spotify catalog information for a single audiobook chapter. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; Chapters
Get Current User's Playlists: Get a list of the playlists owned or followed by the current Spotify user.; PlaylistsLibrary
Get Show: Get Spotify catalog information for a single show identified by its unique Spotify ID.; Shows
Get Show Episodes: Get Spotify catalog information about an show’s episodes. Optional parameters can be used to limit the number of episodes returned.; ShowsEpisodes
Get Available Devices: Get information about a user’s available Spotify Connect devices. Some device models are not supported and will not be listed in the API response.; Player
Get Album: Get Spotify catalog information for a single album.; Albums
Get Album Tracks: Get Spotify catalog information about an album’s tracks. Optional parameters can be used to limit the number of tracks returned.; AlbumsTracks
Get Artist: Get Spotify catalog information for a single artist identified by their unique Spotify ID.; Artists
Get Artist's Albums: Get Spotify catalog information about an artist's albums.; ArtistsAlbums
Get Artist's Related Artists: Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.; Artists
Get Artist's Top Tracks: Get Spotify catalog information about an artist's top tracks by country.; ArtistsTracks
Get an Audiobook: Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; Audiobooks
Get Episode: Get Spotify catalog information for a single episode identified by its unique Spotify ID.; Episodes
Get Track's Audio Analysis: Get a low-level audio analysis for a track in the Spotify catalog. The audio analysis describes the track’s structure and musical content, including rhythm, pitch, and timbre.; Tracks
Get Track's Audio Features: Get audio feature information for a single track identified by its unique Spotify ID.; Tracks
Get Audiobook Chapters: Get Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; AudiobooksChapters
Get Available Markets: Get the list of markets where Spotify is available.; Markets
Get Several Browse Categories: Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).; Categories
Get Current User's Profile: Get detailed profile information about the current user (including the current user's username).; Users
Get Featured Playlists: Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).; Playlists
Get Followed Artists: Get the current user's followed artists.; UsersLibraryArtists
Get Playback State: Get information about the user’s current playback state, including track or episode, progress, and active device.; Player
Get User's Playlists: Get a list of the playlists owned or followed by a Spotify user.; PlaylistsUsers
Get Several Albums: Get Spotify catalog information for multiple albums identified by their Spotify IDs.; Albums
Get Several Artists: Get Spotify catalog information for several artists based on their Spotify IDs.; Artists
Get Several Audiobooks: Get Spotify catalog information for several audiobooks identified by their Spotify IDs. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; Audiobooks
Get Several Episodes: Get Spotify catalog information for several episodes based on their Spotify IDs.; Episodes
Get Several Shows: Get Spotify catalog information for several shows based on their Spotify IDs.; Shows
Get New Releases: Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).; Albums
Get Playlist: Get a playlist owned by a Spotify user.; Playlists
Get Playlist Cover Image: Get the current image associated with a specific playlist.; Playlists
Get Playlist Items: Get full details of the items of a playlist owned by a Spotify user. **Note**: This endpoint is only accessible for playlists owned by the current user or playlists the user is a collaborator of. A `403 Forbidden` status code will be returned if the user is neither the owner nor a collaborator of the playlist.; PlaylistsTracks
Get Playlist Items [DEPRECATED]: **Deprecated:** Use [Get Playlist Items](/documentation/web-api/reference/get-playlists-items) instead. Get full details of the items of a playlist owned by a Spotify user.; PlaylistsTracks
Get the User's Queue: Get the list of objects that make up the user's queue.; Player
Get Recently Played Tracks: Get tracks from the current user's recently played tracks. _**Note**: Currently doesn't support podcast episodes._; Player
Get Available Genre Seeds: Retrieve a list of available genres seed parameter values for [recommendations](/documentation/web-api/reference/get-recommendations).; Genres
Get Recommendations: Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details. For artists and tracks that are very new or obscure there might not be enough data to generate a list of tracks.; Tracks
Get Several Tracks' Audio Features: Get audio features for multiple tracks based on their Spotify IDs.; Tracks
Get Several Chapters: Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; Chapters
Get Several Tracks: Get Spotify catalog information for multiple tracks based on their Spotify IDs.; Tracks
Get Currently Playing Track: Get the object currently being played on the user's Spotify account.; Player
Get Track: Get Spotify catalog information for a single track identified by its unique Spotify ID.; Tracks
Get User's Profile: Get public profile information about a Spotify user.; Users
Get User's Saved Albums: Get a list of the albums saved in the current Spotify user's 'Your Music' library.; AlbumsLibrary
Get User's Saved Audiobooks: Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.; AudiobooksLibrary
Get User's Saved Episodes: Get a list of the episodes saved in the current Spotify user's library.; EpisodesLibrary
Get User's Saved Shows: Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.; ShowsLibrary
Get User's Saved Tracks: Get a list of the songs saved in the current Spotify user's 'Your Music' library.; TracksLibrary
Get User's Top Items: Get the current user's top artists or tracks based on calculated affinity.; UsersTracksLibrary
Pause Playback: Pause playback on the user's account. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Remove Users' Saved Albums: Remove one or more albums from the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; AlbumsLibrary
Remove User's Saved Audiobooks: Remove one or more audiobooks from the Spotify user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; AudiobooksLibrary
Remove User's Saved Episodes: Remove one or more episodes from the current user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; EpisodesLibrary
Remove Playlist Items: Remove one or more items from a user's playlist.; PlaylistsTracks
Remove Items from Library: Remove one or more items from the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.; Library
Remove User's Saved Shows: Delete one or more shows from current Spotify user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; ShowsLibrary
Remove Playlist Items [DEPRECATED]: **Deprecated:** Use [Remove Playlist Items](/documentation/web-api/reference/remove-items-playlist) instead. Remove one or more items from a user's playlist.; PlaylistsTracks
Remove User's Saved Tracks: Remove one or more tracks from the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; TracksLibrary
Update Playlist Items: Either reorder or replace items in a playlist depending on the request's parameters. To reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body. To replace items, include `uris` as either a query parameter or in the request's body. Replacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist. <br/> **Note**: Replace and reorder are mutually exclusive operations which share the same endpoint, but have different parameters. These operations can't be applied together in a single request.; PlaylistsTracks
Update Playlist Items [DEPRECATED]: **Deprecated:** Use [Update Playlist Items](/documentation/web-api/reference/reorder-or-replace-playlists-items) instead. Either reorder or replace items in a playlist depending on the request's parameters. To reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body. To replace items, include `uris` as either a query parameter or in the request's body. Replacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist. <br/> **Note**: Replace and reorder are mutually exclusive operations which share the same endpoint, but have different parameters. These operations can't be applied together in a single request.; PlaylistsTracks
Save Albums for Current User: Save one or more albums to the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; AlbumsLibrary
Save Audiobooks for Current User: Save one or more audiobooks to the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; AudiobooksLibrary
Save Episodes for Current User: Save one or more episodes to the current user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; EpisodesLibrary
Save Items to Library: Add one or more items to the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.; Library
Save Shows for Current User: Save one or more shows to current Spotify user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; ShowsLibrary
Save Tracks for Current User: Save one or more tracks to the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.; TracksLibrary
Search for Item: Get Spotify catalog information about albums, artists, playlists, tracks, shows, episodes or audiobooks that match a keyword string. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.; Search
Seek To Position: Seeks to the given position in the user’s currently playing track. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Set Repeat Mode: Set the repeat mode for the user's playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Set Playback Volume: Set the volume for the user’s current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Skip To Next: Skips to next track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Skip To Previous: Skips to previous track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Start/Resume Playback: Start a new context or resume current playback on the user's active device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Toggle Playback Shuffle: Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Transfer Playback: Transfer playback to a new device and optionally begin playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.; Player
Unfollow Artists or Users: Remove the current user as a follower of one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; UsersArtistsLibrary
Unfollow Playlist: Remove the current user as a follower of a playlist. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.; UsersPlaylists

FAQ

Spotify integration, answered

How do AI agents use Spotify through Open Connector?: Your user connects Spotify once with one of its cataloged authentication methods. Open Connector stores the credential in an encrypted vault and exposes Spotify tools to your agent over MCP or a typed API, with credentials injected server-side on each call.
Is this a Spotify MCP server?: Yes. Open Connector can serve Spotify as a named MCP server with a scoped allowlist and a per-user connection URL, so any MCP client can call Spotify actions with credentials injected server-side.
Where do Spotify credentials live?: In your own infrastructure. Open Connector keeps credentials in its own vault and injects them at call time, so they never leave your environment.

Give your agents Spotify — keep the keys.

Open source, self-hostable, with Spotify credentials that never leave your infrastructure. Run it from source today.

View source on GitHub How the MCP gateway works →