Spotify MCP Node Server

Instructions

Implementation Reference

• src/write.ts:65-113 (handler)

  The handler function that adds tracks to a Spotify playlist by converting track IDs to URIs and calling the Spotify API's addItemsToPlaylist method.
  handler: async (args, extra: SpotifyHandlerExtra) => { const { playlistId, trackIds, position } = args; if (trackIds.length === 0) { return { content: [ { type: 'text', text: 'Error: No track IDs provided', }, ], }; } try { const trackUris = trackIds.map((id) => `spotify:track:${id}`); await handleSpotifyRequest(async (spotifyApi) => { await spotifyApi.playlists.addItemsToPlaylist( playlistId, trackUris, position, ); }); return { content: [ { type: 'text', text: `Successfully added ${trackIds.length} track${ trackIds.length === 1 ? '' : 's' } to playlist (ID: ${playlistId})`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error adding tracks to playlist: ${ error instanceof Error ? error.message : String(error) }`, }, ], }; } }, };
• src/write.ts:56-64 (schema)

  Zod schema defining the input parameters: playlistId (string), trackIds (array of strings), position (optional nonnegative number).
  schema: { playlistId: z.string().describe('The Spotify ID of the playlist'), trackIds: z.array(z.string()).describe('Array of Spotify track IDs to add'), position: z .number() .nonnegative() .optional() .describe('Position to insert the tracks (0-based index)'), },
• src/write.ts:238-243 (registration)

  Exports the addTracksToPlaylist tool as part of the writeTools array.
  export const writeTools = [ addToQueue, addTracksToPlaylist, createPlaylist, removeTracksFromPlaylist, ];
• src/index.ts:12-14 (registration)

  Registers all tools from playTools, readTools, and writeTools (including addTracksToPlaylist) with the MCP server.
  [...playTools, ...readTools, ...writeTools].forEach((tool) => { server.tool(tool.name, tool.description, tool.schema, tool.handler); });
• src/write.ts:82-88 (helper)

  Uses the handleSpotifyRequest helper (imported from utils.ts) to perform the API call securely.
  await handleSpotifyRequest(async (spotifyApi) => { await spotifyApi.playlists.addItemsToPlaylist( playlistId, trackUris, position, ); });