Spotify MCP server Let your AI agent look after your playlists.

ToolWhat it doesAccess

• search Search the catalog for songs, artists, albums, playlists or podcasts. read

  search returns the results Spotify shows for the query, with a link for each one that the other tools accept. With type set, it returns only that kind of result. Results are in the order Spotify ranks them, and next_cursor loads more. It reads only, so it asks no confirmation.

  MCP callspotify_read → search

  REST endpointGET https://cotlet.dev/api/v1/spotify/search/search

  Parameters

  Parameters: search

  Name	Type	Description
  query string required	string	What to search for, as you would type it in the Spotify search box.
  type string	string	Spotify search filter. One of song, artist, album, playlist, podcast. Omit it to search everything.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "results": [
      {
        "type": "song",
        "title": "Midnight City",
        "artists": [
          "M83"
        ],
        "album": "Hurry Up, We're Dreaming",
        "url": "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp"
      },
      {
        "type": "song",
        "title": "Midnight City (Eric Prydz Private Remix)",
        "artists": [
          "M83",
          "Eric Prydz"
        ],
        "album": "Midnight City Remixes",
        "url": "https://open.spotify.com/track/4ZmOtN4xV3cWk9QpAbT2Dm"
      }
    ],
    "next_cursor": null
  }

ToolWhat it doesAccess

• list_playlists List the playlists in Your Library: the ones you made and the ones you follow. read

  list_playlists returns each playlist with its name, owner, link, song count and whether it is public or private. It opens each playlist page to read the count and visibility, so a library with many playlists takes longer. The order is the one Your Library shows. It reads only, so it asks no confirmation.

  MCP callspotify_read → list_playlists

  REST endpointGET https://cotlet.dev/api/v1/spotify/playlists

  Parameters

  Parameters: list_playlists

  Name	Type	Description
  owned_only boolean	boolean	Only playlists you made. Default false, which also lists playlists you follow, such as Discover Weekly.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "playlists": [
      {
        "name": "Road trip",
        "owner": "Maya Rivera",
        "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
        "songs": 64,
        "visibility": "private"
      },
      {
        "name": "Focus",
        "owner": "Maya Rivera",
        "url": "https://open.spotify.com/playlist/5Hq0wF9xYtLmN2vKd8RjAe",
        "songs": 112,
        "visibility": "public"
      },
      {
        "name": "Discover Weekly",
        "owner": "Spotify",
        "url": "https://open.spotify.com/playlist/37i9dQZEVXcJZyENOWUFo7",
        "songs": 30,
        "visibility": "public"
      }
    ],
    "next_cursor": null
  }

• get_playlist_items Return the songs of one playlist, including playlists you follow. read

  get_playlist_items returns each song with its position, title, artists, album, length, the date it was added and its link. It reads the playlist page you see in Spotify, so it also works on a playlist you only follow, such as Discover Weekly. Long playlists come back in pages: pass next_cursor to continue. It reads only, so it asks no confirmation.

  MCP callspotify_read → get_playlist_items

  REST endpointGET https://cotlet.dev/api/v1/spotify/playlist-items

  Parameters

  Parameters: get_playlist_items

  Name	Type	Description
  playlist_url string required	string	Playlist link from list_playlists or search, like https://open.spotify.com/playlist/{id}.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "playlist_url": "https://example.com"
  }

  Example response

  {
    "playlist": "Road trip",
    "items": [
      {
        "position": 1,
        "title": "Midnight City",
        "artists": [
          "M83"
        ],
        "album": "Hurry Up, We're Dreaming",
        "length": "4:03",
        "added_at": "2026-09-14",
        "url": "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp"
      },
      {
        "position": 2,
        "title": "Dog Days Are Over",
        "artists": [
          "Florence + The Machine"
        ],
        "album": "Lungs",
        "length": "4:12",
        "added_at": "2026-09-14",
        "url": "https://open.spotify.com/track/1VZt8sG4cRpWq3hJmYn0Lk"
      },
      {
        "position": 3,
        "title": "Midnight City",
        "artists": [
          "M83"
        ],
        "album": "Hurry Up, We're Dreaming",
        "length": "4:03",
        "added_at": "2026-10-02",
        "url": "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp"
      }
    ],
    "next_cursor": null
  }

• create_playlist Create an empty private playlist in Your Library. write

  create_playlist makes a new playlist the way Your Library > Create > Playlist does, and returns its link for add_to_playlist. The playlist is created private, so it reaches no one until you call set_playlist_visibility, and one delete_playlist call undoes it. For that reason it asks no confirmation by default.

  MCP callspotify_write → create_playlist

  REST endpointPOST https://cotlet.dev/api/v1/spotify/playlists

  Parameters

  Parameters: create_playlist

  Name	Type	Description
  name string required	string	Playlist name.
  description string	string	Optional description.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "name": "Friday setlist",
    "url": "https://open.spotify.com/playlist/6KtB3yQmZd1WxPaN0cVhRs",
    "visibility": "private",
    "songs": 0
  }

• add_to_playlist Add songs to a playlist you made, using Add to Playlist. writeasks first

  add_to_playlist adds each song through the Add to Playlist menu and reports which songs it added and which it skipped because they were already in the playlist or could not be found. Compare with get_playlist_items first if you want to control duplicates. People who follow a public playlist see the change. By default you confirm each call; you can switch that off for this tool.

  MCP callspotify_write → add_to_playlist

  REST endpointPOST https://cotlet.dev/api/v1/spotify/playlists/add-to-playlist

  Parameters

  Parameters: add_to_playlist

  Name	Type	Description
  playlist_url string required	string	Playlist link from list_playlists or search, like https://open.spotify.com/playlist/{id}.
  song_urls string[] required	string[]	Song links from search, get_playlist_items or list_liked_songs, like https://open.spotify.com/track/{id}.

  Example input

  {
    "playlist_url": "https://open.spotify.com/playlist/6KtB3yQmZd1WxPaN0cVhRs",
    "song_urls": [
      "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp",
      "https://open.spotify.com/track/1VZt8sG4cRpWq3hJmYn0Lk"
    ]
  }

  Example response

  {
    "playlist": "Friday setlist",
    "added": 3,
    "skipped": [],
    "songs_now": 3
  }

• remove_from_playlist Remove songs from a playlist you made, using Remove from this Playlist. writeasks first

  remove_from_playlist removes each listed song with Remove from this Playlist and returns how many it removed. When a song appears in the playlist more than once, the agent should say which copies to remove. People who follow a public playlist see the change. By default you confirm each call; you can switch that off for this tool.

  MCP callspotify_write → remove_from_playlist

  REST endpointDELETE https://cotlet.dev/api/v1/spotify/playlists

  Parameters

  Parameters: remove_from_playlist

  Name	Type	Description
  playlist_url string required	string	Playlist link from list_playlists or search, like https://open.spotify.com/playlist/{id}.
  song_urls string[] required	string[]	Song links from search, get_playlist_items or list_liked_songs, like https://open.spotify.com/track/{id}.

  Example input

  {
    "playlist_url": "https://example.com",
    "song_urls": [
      "https://example.com"
    ]
  }

  Example response

  {
    "playlist": "Road trip",
    "removed": 1,
    "songs_now": 63
  }

• set_playlist_visibility Switch a playlist you made between public and private. writeasks first

  set_playlist_visibility uses Make public or Make private in the playlist menu. A private playlist cannot be opened by anyone else, even with its link, and it leaves your profile. A public playlist is shown on your profile. By default you confirm each call; you can switch that off for this tool.

  MCP callspotify_write → set_playlist_visibility

  REST endpointPUT https://cotlet.dev/api/v1/spotify/playlist-visibility

  Parameters

  Parameters: set_playlist_visibility

  Name	Type	Description
  playlist_url string required	string	Playlist link from list_playlists or search, like https://open.spotify.com/playlist/{id}.
  visibility string required	string	One of public, private.

  Example input

  {
    "playlist_url": "https://example.com",
    "visibility": "visibility"
  }

  Example response

  {
    "name": "Focus",
    "visibility": "private"
  }

• delete_playlist Delete a playlist from Your Library. writeasks first

  delete_playlist uses the Delete option of the playlist menu. A deleted playlist disappears from your profile and from the people who followed it. Spotify keeps a way to recover a deleted playlist, described in its help center, but the agent should not rely on it. By default you confirm each call; you can switch that off for this tool.

  MCP callspotify_write → delete_playlist

  REST endpointDELETE https://cotlet.dev/api/v1/spotify/playlists/delete-playlist

  Parameters

  Parameters: delete_playlist

  Name	Type	Description
  playlist_url string required	string	Playlist link from list_playlists or search, like https://open.spotify.com/playlist/{id}.

  Example input

  {
    "playlist_url": "https://example.com"
  }

  Example response

  {
    "deleted": true,
    "name": "Old workout mix"
  }

ToolWhat it doesAccess

• list_liked_songs Return the songs saved to your Liked Songs, with the date you saved each. read

  list_liked_songs returns each saved song with its title, artists, album, the date it was saved and its link, in the order Spotify shows them. Liked Songs sits under Playlists in Your Library. Pass next_cursor to continue through a long library. It reads only, so it asks no confirmation.

  MCP callspotify_read → list_liked_songs

  REST endpointGET https://cotlet.dev/api/v1/spotify/liked-songs

  Parameters

  Parameters: list_liked_songs

  Name	Type	Description
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "items": [
      {
        "title": "Dog Days Are Over",
        "artists": [
          "Florence + The Machine"
        ],
        "album": "Lungs",
        "added_at": "2026-11-02",
        "url": "https://open.spotify.com/track/1VZt8sG4cRpWq3hJmYn0Lk"
      },
      {
        "title": "Midnight City",
        "artists": [
          "M83"
        ],
        "album": "Hurry Up, We're Dreaming",
        "added_at": "2026-10-28",
        "url": "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp"
      }
    ],
    "next_cursor": null
  }

• like_songs Save songs to your Liked Songs. write

  like_songs saves each song to Liked Songs with the Add or Save button and returns how many it saved. It changes only your own library and one unlike_songs call undoes it, so it asks no confirmation by default.

  MCP callspotify_write → like_songs

  REST endpointPOST https://cotlet.dev/api/v1/spotify/songs/like

  Parameters

  Parameters: like_songs

  Name	Type	Description
  song_urls string[] required	string[]	Song links from search, get_playlist_items or list_liked_songs, like https://open.spotify.com/track/{id}.

  Example input

  {
    "song_urls": [
      "https://example.com"
    ]
  }

  Example response

  {
    "saved": 2,
    "already_saved": 0
  }

• unlike_songs Remove songs from your Liked Songs. write

  unlike_songs removes each song from Liked Songs and returns how many it removed. It changes only your own library and one like_songs call undoes it, so it asks no confirmation by default.

  MCP callspotify_write → unlike_songs

  REST endpointPOST https://cotlet.dev/api/v1/spotify/songs/unlike

  Parameters

  Parameters: unlike_songs

  Name	Type	Description
  song_urls string[] required	string[]	Song links from search, get_playlist_items or list_liked_songs, like https://open.spotify.com/track/{id}.

  Example input

  {
    "song_urls": [
      "https://example.com"
    ]
  }

  Example response

  {
    "removed": 2,
    "not_in_library": 0
  }

• list_recent_plays Return the songs on your Recents list. read

  list_recent_plays returns the songs Spotify shows under Recents, with title, artists, album and link. On desktop Spotify shows the last 50 songs you listened to there. Songs you played earlier are not on the list, so run it often if you want a longer history. It reads only, so it asks no confirmation.

  MCP callspotify_read → list_recent_plays

  REST endpointGET https://cotlet.dev/api/v1/spotify/recent-plays

  Parameters

  No parameters.

  Example response

  {
    "items": [
      {
        "title": "Dog Days Are Over",
        "artists": [
          "Florence + The Machine"
        ],
        "album": "Lungs",
        "url": "https://open.spotify.com/track/1VZt8sG4cRpWq3hJmYn0Lk"
      },
      {
        "title": "Midnight City",
        "artists": [
          "M83"
        ],
        "album": "Hurry Up, We're Dreaming",
        "url": "https://open.spotify.com/track/1eyzqe2QqGZUmfcPZtt1xp"
      }
    ]
  }