Spotify Model Context Protocol

Instructions

Update an existing Spotify playlist's details and/or tracks.

Args:
    playlist_id: The Spotify ID of the playlist to update
    name: New name for the playlist (optional)
    track_uris: New list of track URIs to replace the playlist's tracks (optional)
    description: New description for the playlist (optional)
    public: New public/private status for the playlist (optional)

Implementation Reference

• spotify.py:97-145 (handler)

  Main handler function for the 'update_playlist' MCP tool. Handles user authentication, token refresh if needed, updates playlist details (name, description, public), and optionally replaces all tracks in the playlist.

  @mcp.tool("update_playlist")
  def update_playlist(playlist_id: str, name: str = None, track_uris: List[str] = None, description: str = None, public: bool = None) -> dict:
      """
      Update an existing Spotify playlist's details and/or tracks.
  
      Args:
          playlist_id: The Spotify ID of the playlist to update
          name: New name for the playlist (optional)
          track_uris: New list of track URIs to replace the playlist's tracks (optional)
          description: New description for the playlist (optional)
          public: New public/private status for the playlist (optional)
      """
      user_id = get_current_user_id()
      tokens = get_user_tokens(user_id)
      if not tokens:
          raise Exception("No tokens found for user")
  
      if tokens["token_expiry"] < time.time():
          tokens = spotify_client.refresh_access_token(tokens["refresh_token"])
          update_access_token(user_id, tokens["access_token"], tokens.get("expires_in", 3600))
      
      result = {}
      
      # Update playlist details if any are provided
      if any([name, description, public is not None]):
          details_result = spotify_client.update_playlist_details(
              access_token=tokens["access_token"],
              playlist_id=playlist_id,
              name=name,
              description=description,
              public=public
          )
          if details_result:
              result.update(details_result)
          else:
              return {"error": "Failed to update playlist details"}
      
      # Update tracks if provided
      if track_uris is not None:
          tracks_updated = spotify_client.replace_playlist_tracks(
              access_token=tokens["access_token"],
              playlist_id=playlist_id,
              track_uris=track_uris
          )
          if not tracks_updated:
              return {"error": "Failed to update playlist tracks"}
          result["tracks_updated"] = True
      
      return result

• spotify_client.py:156-199 (helper)

  Helper method in SpotifyClient class that performs the API call to update playlist metadata using Spotify's PUT /playlists/{playlist_id} endpoint.

  def update_playlist_details(self, access_token: str, playlist_id: str, name: str = None, description: str = None, public: bool = None) -> dict:
      """
      Updates an existing playlist's details.
      
      Args:
          access_token: Spotify access token
          playlist_id: ID of the playlist to update
          name: New name for the playlist (optional)
          description: New description for the playlist (optional)
          public: New public/private status for the playlist (optional)
          
      Returns:
          Dictionary containing playlist details if successful, None otherwise
      """
      headers = {
          "Authorization": f"Bearer {access_token}",
          "Content-Type": "application/json"
      }
      
      playlist_data = {}
      if name is not None:
          playlist_data["name"] = name
      if description is not None:
          playlist_data["description"] = description
      if public is not None:
          playlist_data["public"] = public
          
      response = requests.put(
          f"{self.base_url}/playlists/{playlist_id}",
          headers=headers,
          json=playlist_data
      )
      
      if response.status_code == 200:
          return {
              "id": playlist_id,
              "name": name if name is not None else "",
              "description": description if description is not None else "",
              "public": public if public is not None else False,
              "tracks": {"total": 0},
              "type": "playlist",
              "uri": f"spotify:playlist:{playlist_id}"
          }
      return None

• spotify_client.py:201-228 (helper)

  Helper method in SpotifyClient class that replaces all tracks in a playlist using Spotify's PUT /playlists/{playlist_id}/tracks endpoint.

  def replace_playlist_tracks(self, access_token: str, playlist_id: str, track_uris: List[str]) -> bool:
      """
      Replaces all tracks in a playlist with new ones.
      
      Args:
          access_token: Spotify access token
          playlist_id: ID of the playlist to update
          track_uris: New list of track URIs to replace existing tracks
          
      Returns:
          True if successful, False otherwise
      """
      headers = {
          "Authorization": f"Bearer {access_token}",
          "Content-Type": "application/json"
      }
      
      tracks_data = {
          "uris": track_uris
      }
      
      response = requests.put(
          f"{self.base_url}/playlists/{playlist_id}/tracks",
          headers=headers,
          json=tracks_data
      )
      
      return response.status_code == 200

• spotify.py:97-97 (registration)

  MCP tool registration decorator that registers the update_playlist function with name 'update_playlist'.

  @mcp.tool("update_playlist")

• spotify.py:98-108 (schema)

  Function signature with type annotations and docstring defining the input schema (parameters) and output type for the tool.

  def update_playlist(playlist_id: str, name: str = None, track_uris: List[str] = None, description: str = None, public: bool = None) -> dict:
      """
      Update an existing Spotify playlist's details and/or tracks.
  
      Args:
          playlist_id: The Spotify ID of the playlist to update
          name: New name for the playlist (optional)
          track_uris: New list of track URIs to replace the playlist's tracks (optional)
          description: New description for the playlist (optional)
          public: New public/private status for the playlist (optional)
      """