Spotify MCP Node Server

Instructions

Implementation Reference

• src/write.ts:188-235 (handler)

  The async handler function that implements the tool logic: validates input, constructs track URIs, calls Spotify API to remove items from playlist, and returns success/error messages.

  handler: async (args, extra: SpotifyHandlerExtra) => {
    const { playlistId, trackIds } = args;
  
    if (trackIds.length === 0) {
      return {
        content: [
          {
            type: 'text',
            text: 'Error: No track IDs provided',
          },
        ],
      };
    }
  
    try {
      const tracks = trackIds.map((id) => ({
        uri: `spotify:track:${id}`,
      }));
  
      await handleSpotifyRequest(async (spotifyApi) => {
        await spotifyApi.playlists.removeItemsFromPlaylist(playlistId, {
          tracks,
        });
      });
  
      return {
        content: [
          {
            type: 'text',
            text: `Successfully removed ${trackIds.length} track${
              trackIds.length === 1 ? '' : 's'
            } from playlist (ID: ${playlistId})`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error removing tracks from playlist: ${
              error instanceof Error ? error.message : String(error)
            }`,
          },
        ],
      };
    }
  },

• src/write.ts:182-187 (schema)

  Zod schema for input validation: requires playlistId (string) and trackIds (array of strings).

  schema: {
    playlistId: z.string().describe('The Spotify ID of the playlist'),
    trackIds: z
      .array(z.string())
      .describe('Array of Spotify track IDs to remove'),
  },

• src/write.ts:238-243 (registration)

  Includes the removeTracksFromPlaylist tool in the exported writeTools array, which is imported and registered elsewhere.

  export const writeTools = [
    addToQueue,
    addTracksToPlaylist,
    createPlaylist,
    removeTracksFromPlaylist,
  ];

• src/index.ts:12-14 (registration)

  Registers all tools from playTools, readTools, and writeTools arrays with the MCP server by calling server.tool() for each.

  [...playTools, ...readTools, ...writeTools].forEach((tool) => {
    server.tool(tool.name, tool.description, tool.schema, tool.handler);
  });