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,
    );
  });