add_tracks_to_playlist

Add tracks to a Spotify playlist using track URIs and specify playlist ID. Insert tracks at a specific position if needed.

Instructions

Add one or more tracks to a playlist

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	The Spotify ID or URI of the playlist
`uris`	Yes	Array of Spotify track URIs to add
`position`	No	Optional. The position to insert the tracks (zero-based)

Implementation Reference

src/handlers/playlists.ts:72-86 (handler)

The core handler function implementing add_tracks_to_playlist by extracting playlist ID, preparing data with URIs and optional position, and making a POST request to Spotify API endpoint /playlists/{id}/tracks.

async addTracksToPlaylist(args: AddTracksToPlaylistArgs) {
  const playlistId = this.extractPlaylistId(args.id);
  const { uris, position } = args;

  const data = {
    uris,
    ...(position !== undefined && { position })
  };

  return this.api.makeRequest(
    `/playlists/${playlistId}/tracks`,
    'POST',
    data
  );
}

src/types/playlists.ts:25-29 (schema)
TypeScript interface defining the input parameters for the addTracksToPlaylist handler: playlist ID, array of track URIs, and optional insert position.
```
export interface AddTracksToPlaylistArgs {
  id: string;
  uris: string[];
  position?: number;
}
```

src/index.ts:557-580 (registration)

MCP tool registration in listTools response, defining the name, description, and inputSchema matching the handler args.

{
  name: 'add_tracks_to_playlist',
  description: 'Add one or more tracks to a playlist',
  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'string',
        description: 'The Spotify ID or URI of the playlist'
      },
      uris: {
        type: 'array',
        items: { type: 'string' },
        description: 'Array of Spotify track URIs to add'
      },
      position: {
        type: 'number',
        description: 'Optional. The position to insert the tracks (zero-based)',
        minimum: 0
      }
    },
    required: ['id', 'uris']
  },
},

src/index.ts:861-867 (registration)

Dispatch logic in the main CallToolRequest handler switch statement: validates required args and delegates to playlistsHandler.addTracksToPlaylist

case 'add_tracks_to_playlist': {
  const args = this.validateArgs<AddTracksToPlaylistArgs>(request.params.arguments, ['id', 'uris']);
  const result = await this.playlistsHandler.addTracksToPlaylist(args);
  return {
    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
  };
}

src/handlers/playlists.ts:8-10 (helper)
Helper method used by addTracksToPlaylist (and others) to normalize playlist ID from Spotify URI or plain ID.
```
private extractPlaylistId(id: string): string {
  return id.startsWith('spotify:playlist:') ? id.split(':')[2] : id;
}
```

MCP Spotify Server