How to integrate Spotify MCP with Atomic Agent

Connect Atomic Agent to Spotify MCP. Add these songs to your running playlist, check if i follow taylor swift, and more using natural language, with authentication handled for you.

Spotify logoSpotify
Oauth2

Spotify is a streaming service for music and podcasts with millions of tracks from artists worldwide. Enjoy personalized playlists, recommendations, and seamless listening across all your devices.

84 Tools3 Triggers

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Spotify.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Spotify account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Spotify with

How Atomic Agent connects to Spotify

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Spotify to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Spotify. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Spotify account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Spotify MCP server, and what's possible with it?

The Spotify MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Spotify account. It provides structured and secure access to your playlists, music library, and playback controls, so your agent can perform actions like managing playlists, adding songs to your queue, checking saved tracks, and updating playlist details on your behalf.

  • Personalized playlist management: Let your agent add songs or podcasts to playlists, change playlist details like name or privacy settings, and keep your music organized just how you like it.
  • Playback control and queue updates: Direct your agent to add tracks or episodes to your current playback queue, helping you line up the perfect listening experience without lifting a finger.
  • Library checks and smart recommendations: Have your agent check if specific tracks, albums, shows, or audiobooks are already saved in your Spotify library, so you never add duplicates or miss out on favorites.
  • Social and follower insights: Ask your agent to check whether you or others are following certain artists, users, or playlists, making it easy to stay connected to your musical community.
  • Podcast and show management: Let your agent verify which podcast episodes or shows are in your library, ensuring you’re always up to date with your latest audio interests.

Use Spotify from Atomic Agent

With your account connected, ask Atomic Agent to work with Spotify in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Spotify action and event your agent gets out of the box.

Add items to playlist

Add one or more items to a user's playlist.

Add item to playback queue

Add an item to the end of the user's current playback queue.

Change playlist details

Change a playlist's name and public/private state.

Check if user follows artists or users

Check whether the current user follows up to 50 specified artists or Spotify users.

Check if users follow playlist

Check whether the authenticated user follows a specified public or owned Spotify playlist.

Check user s saved albums

Check whether up to 20 albums, identified by Spotify ID, are saved in the current user's library.

Check user s saved audiobooks

Check whether up to 50 audiobooks, identified by Spotify ID, are saved in the current user's library.

Check User's Saved Episodes

Check whether up to 50 podcast episodes by ID are saved in the current user's Your Episodes library.

Check user's saved shows

Check whether up to 50 shows, identified by Spotify ID, are saved in the current user's library.

Check User's Saved Tracks

Check whether up to 50 tracks, identified by Spotify track ID, are saved in the current user's library.

Create playlist

Create an empty playlist for a Spotify user, with a name and optional description, visibility, and collaboration settings.

Follow artists or users

Follow one or more artists or Spotify users by ID for the current authenticated user, adding them to the user's following list.

Follow playlist

Follow a playlist for the current Spotify user by playlist ID, publicly or privately.

Get a chapter

Get Spotify catalog information for a single audiobook chapter including name, description, duration, release date, narrators, and playback information.

Get Album Details

Get Spotify catalog information for a single album by ID, including metadata, track listing, artist information and cover artwork.

Get album tracks

Get Spotify catalog information about an album's tracks.

Get an audiobook

Get Spotify catalog information for a single audiobook.

Get artist

Get detailed Spotify catalog information for a single artist, including name, genres, profile images and Spotify links.

Get artist s albums

Get Spotify catalog information about an artist's albums.

Get artist s related artists

Get Spotify catalog information about artists similar to a given artist.

Get Artist's Top Tracks

Get Spotify catalog information about an artist's top tracks in a specified market, defaulting to the US.

Get audiobook chapters

Get Spotify catalog information about an audiobook's chapters.

Get Available Devices

Get information about the user's available Spotify Connect devices.

Get available markets

Get the list of markets where Spotify is available, as ISO 3166-1 alpha-2 country codes.

Get currently playing track

Get the object currently being played on the user's Spotify account.

Get current user s playlists

Get a paginated list of playlists owned or followed by the current Spotify user, with playlist metadata and pagination links.

Get current user s profile

Get profile information for the current authenticated Spotify user, including available display name, images and Spotify URIs.

Get episode

Get Spotify catalog information for a single podcast episode identified by its unique Spotify ID.

Get featured playlists

Get a list of Spotify's editorially curated featured playlists.

Get followed artists

Get a cursor-paginated list of artists followed by the current Spotify user using the after parameter; requires user-follow-read.

Get new releases

Get a page of new album releases featured by Spotify, such as those shown in Browse.

Get playback state

Get the current user's Spotify playback state, including the active device, current track or episode, progress, playback context, and repeat and shuffle settings.

Get playlist

Get metadata and available contents of a Spotify playlist, with optional field filtering.

Get playlist cover image

Get the current cover images associated with a playlist.

Get playlist items

Get a paginated list of tracks or episodes in a playlist, with optional response field filtering.

Get recently played tracks

Get tracks from the current user's recently played tracks.

Get recommendations

Get track recommendations based on seed artists, genres, and/or tracks.

Get several albums

Get Spotify catalog information for up to 20 albums by Spotify ID, optionally specifying a market.

Get several artists

Get Spotify catalog information for up to 50 artists in one request using their Spotify IDs.

Get several audiobooks

Get Spotify catalog information for up to 50 audiobooks by ID in a single request, optionally specifying a market.

Get several browse categories

List Spotify browse categories used to tag items, with locale and limit/offset pagination.

Get several chapters

Get Spotify catalog details for up to 50 audiobook chapters by ID, including chapter metadata and parent audiobook information.

Get several episodes

Get Spotify catalog information for up to 50 episodes by their IDs in a single request, with an optional market.

Get several shows

Get Spotify catalog information for up to 50 shows by ID in a single request, optionally specifying a market.

Get several tracks

Get Spotify catalog information for multiple tracks by Spotify ID, with an optional market.

Get show

Get Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.

Get show episodes

Get Spotify catalog information about a show's episodes.

Get single browse category

Get information about a Spotify browse category by ID, including its name and icons, with an optional locale.

Get the user's queue

Get the list of tracks and episodes in the user's playback queue.

Get track

Get Spotify catalog information for a single track identified by its unique Spotify ID.

Get Track's Audio Analysis

Get a comprehensive audio analysis for a Spotify track.

Get user's playlists

Get a paginated list of playlists owned or followed by a specified Spotify user, using limit and offset.

Get user's profile

Retrieve public profile information for a Spotify user by user ID, such as their display name and profile images.

Get user s saved albums

Get a list of albums saved in the current Spotify user's library ('Your Music').

Get user s saved audiobooks

Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.

Get user's saved episodes

Get a list of episodes saved in the current Spotify user's library.

Get User's Saved Shows

Get a list of shows saved in the current Spotify user's library.

Get User's Saved Tracks

Get a list of the songs saved in the current Spotify user's 'Your Music' library.

Get User's Top Artists

Get a paginated list of the current user's top artists based on listening affinity over a selected time range; requires user-top-read.

Get User's Top Tracks

Get the current user's top tracks based on listening affinity over a selected time range.

Pause playback

Pause playback on the user's account.

Remove playlist items

Remove one or more items from a user's playlist.

Remove users saved albums

Remove one or more albums from the current user's saved library.

Remove User's Saved Audiobooks

Remove one or more saved audiobooks from the current user's Spotify library by ID.

Remove user's saved episodes

Remove up to 50 episodes by ID from the current user's Your Episodes library; removing an unsaved episode succeeds.

Remove user s saved shows

Remove one or more shows by Spotify ID from the current user's library.

Remove user s saved tracks

Remove one or more tracks by Spotify ID from the current user's library.

Save albums for current user

Save one or more albums by Spotify ID to the current user's library.

Save audiobooks for current user

Save up to 50 audiobooks by Spotify ID to the current user's library for later access.

Save episodes for current user

Save up to 50 podcast episodes by Spotify ID to the current user's Your Episodes library for later playback.

Save shows for current user

Save up to 50 shows by Spotify ID to the current user's library.

Save tracks for current user

Save tracks to the current user's Spotify library using up to 50 track IDs or timestamped IDs.

Search for item

Search Spotify's catalog for albums, artists, playlists, tracks, shows, episodes or audiobooks matching a keyword.

Seek to position

Seek to a position in milliseconds in the user's currently playing track, targeting a specified device or the active device by default.

Set playback volume

Set the volume for the user's current playback device.

Set repeat mode

Set the repeat mode for the user's playback.

Skip to next

Skips to next track in the user's queue.

Skip to previous

Skips to the previous track in the user's queue.

Start resume playback

Start playback of a context or list of tracks, or resume playback on a Spotify device.

Toggle playback shuffle

Toggle shuffle on or off for user's playback.

Transfer playback

Transfer playback to a new device and optionally begin playback.

Unfollow artists or users

Unfollow up to 50 artists or Spotify users by ID for the current user, removing them from the following list.

Unfollow playlist

Unfollow a playlist by ID for the current user, removing it from their followed playlists.

Update playlist items

Either replace all tracks in a playlist OR reorder existing tracks within it.

FAQ

Frequently asked questions

Start with Spotify.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Spotify tool your agent needs.Free to start.

Start building