Spotify MCP

Instructions

Implementation Reference

• main.py:188-196 (handler)

  MCP tool handler and registration for add_to_playlist. This is the entrypoint function executed when the tool is called, delegating to the SpotifyClient.
  @mcp.tool() async def add_to_playlist(playlist_id: str, track_ids: list[str]) -> str: """ Add tracks to a playlist Args: playlist_id: Spotify playlist ID track_ids: List of track IDs to add """ return await client.add_to_playlist(playlist_id, track_ids)
• spotify.py:306-318 (helper)

  Core helper function in SpotifyClient that implements the logic: converts track IDs to Spotify URIs and adds items to the playlist using spotipy.Spotify.playlist_add_items.
  async def add_to_playlist(self, playlist_id: str, track_ids: list[str]) -> str: """ Add tracks to a playlist - playlist_id: Spotify playlist ID - track_ids: List of track IDs to add """ try: # Convert track IDs to full URIs track_uris = [f"spotify:track:{track_id}" for track_id in track_ids] self.sp.playlist_add_items(playlist_id, track_uris) return "Tracks added to playlist successfully" except Exception as e: return f"Error adding tracks to playlist: {str(e)}"
• main.py:5-5 (helper)

  Instantiation of the global SpotifyClient instance used by all tool handlers.
  client = SpotifyClient()
• main.py:4-4 (registration)

  Initialization of the FastMCP server instance where tools are registered.
  mcp = FastMCP("spotify")