Spotify MCP Server

Instructions

Implementation Reference

• src/read.ts:211-249 (handler)

  The main handler function that implements the tool logic: fetches the current user's playlists using the Spotify API, handles empty results, formats the playlist list with track counts and IDs, and returns a formatted text response.

    handler: async (args, _extra: SpotifyHandlerExtra) => {
      const { limit = 50 } = args;
  
      const playlists = await handleSpotifyRequest(async (spotifyApi) => {
        return await spotifyApi.currentUser.playlists.playlists(
          limit as MaxInt<50>,
        );
      });
  
      if (playlists.items.length === 0) {
        return {
          content: [
            {
              type: 'text',
              text: "You don't have any playlists on Spotify",
            },
          ],
        };
      }
  
      const formattedPlaylists = playlists.items
        .map((playlist, i) => {
          const tracksTotal = playlist.tracks?.total ? playlist.tracks.total : 0;
          return `${i + 1}. "${playlist.name}" (${tracksTotal} tracks) - ID: ${
            playlist.id
          }`;
        })
        .join('\n');
  
      return {
        content: [
          {
            type: 'text',
            text: `# Your Spotify Playlists\n\n${formattedPlaylists}`,
          },
        ],
      };
    },
  };

• src/read.ts:203-210 (schema)

  Zod schema defining the optional 'limit' parameter for the number of playlists to fetch (1-50).

  schema: {
    limit: z
      .number()
      .min(1)
      .max(50)
      .optional()
      .describe('Maximum number of playlists to return (1-50)'),
  },

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

  Registration of all tools, including getMyPlaylists from readTools, with the MCP server using server.tool().

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

• src/read.ts:603-612 (registration)

  The getMyPlaylists tool is included in the exported readTools array, which is imported and registered in index.ts.

  export const readTools = [
    searchSpotify,
    getNowPlaying,
    getMyPlaylists,
    getPlaylistTracks,
    getRecentlyPlayed,
    getUsersSavedTracks,
    getQueue,
    getAvailableDevices,
  ];