Spotify MCP Server

Instructions

Implementation Reference

• src/play.ts:182-203 (handler)

  The handler function for the 'createPlaylist' tool. It destructures args, gets the current user profile, creates the playlist using spotifyApi.playlists.createPlaylist, and returns a success message with the playlist ID.

  handler: async (args, _extra: SpotifyHandlerExtra) => {
    const { name, description, public: isPublic = false } = args;
  
    const result = await handleSpotifyRequest(async (spotifyApi) => {
      const me = await spotifyApi.currentUser.profile();
  
      return await spotifyApi.playlists.createPlaylist(me.id, {
        name,
        description,
        public: isPublic,
      });
    });
  
    return {
      content: [
        {
          type: 'text',
          text: `Successfully created playlist "${name}"\nPlaylist ID: ${result.id}`,
        },
      ],
    };
  },

• src/play.ts:171-181 (schema)

  Zod input schema for the 'createPlaylist' tool defining required 'name' string, optional 'description' string, and optional 'public' boolean.

  schema: {
    name: z.string().describe('The name of the playlist'),
    description: z
      .string()
      .optional()
      .describe('The description of the playlist'),
    public: z
      .boolean()
      .optional()
      .describe('Whether the playlist should be public'),
  },

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

  Main MCP server registration loop that registers the 'createPlaylist' tool (via playTools) by calling server.tool with its name, description, schema, and handler.

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

• src/play.ts:362-371 (registration)

  Local grouping of play-related tools including 'createPlaylist' in the exported playTools array, which is then registered in index.ts.

  export const playTools = [
    playMusic,
    pausePlayback,
    skipToNext,
    skipToPrevious,
    createPlaylist,
    addTracksToPlaylist,
    resumePlayback,
    addToQueue,
  ];