How to connect Spotify to Claude

Connect Claude Web, Desktop and Cowork 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

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Spotify account to Claude via Composio Connect, enabling it to add these songs to your running playlist, check if I follow Taylor Swift, see if your friends follow your playlist, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

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

Also integrate Spotify with

Connecting Spotify to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Spotify account

Back in Claude, ask it to connect to Spotify or give it any Spotify-related task.

For example, ask Claude to:

  • "Add these songs to your running playlist"
  • "Check if I follow Taylor Swift"
  • "See if your friends follow your playlist"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Spotify account is ready to use.

What is the Spotify Claude Connector, 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.

Troubleshooting

1. Why does Claude not use the Composio connector for Spotify?

The connector can show as connected, but Claude must use it in each Spotify conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Spotify again.

2. Why does Claude show an MCP server error before Spotify connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Spotify.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Spotify.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Spotify authorization link not work?

The Composio connector is one server. Your Spotify account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Spotify connection.
  • Composio creates a fresh Spotify authorization link.
  • Open that link in your browser and finish the Spotify sign-in.

4. Why do Spotify actions fail after they worked before?

The Spotify connection can expire or lose permission.

  • Ask Claude to inspect the Spotify connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Spotify account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Spotify.
  • If the action still fails with a permission error, check that the connected account has that permission in Spotify itself.

5. How do I switch to a different Spotify account?

Claude can manage the Spotify connection for you.

  • Ask Claude to disconnect or delete the current Spotify account.
  • Ask Claude to connect Spotify again.
  • Open the new Composio authorization link for Spotify.
  • Sign in with the other Spotify account in the browser.
  • After the account connects, ask Claude to retry the Spotify task.

6. Why is my Spotify connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Spotify connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Spotify tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Spotify.
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