createPlaylist
Create a new Spotify playlist with custom name, description, and privacy settings to organize your music collection.
Instructions
Create a new playlist on Spotify
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name of the playlist | |
| description | No | The description of the playlist | |
| public | No | Whether the playlist should be public |
Implementation Reference
- src/write.ts:25-46 (handler)The handler function that destructures arguments, fetches current user profile, creates the playlist via Spotify API, and returns success message with 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/write.ts:14-24 (schema)Zod schema defining input parameters for createPlaylist: required name (string), optional description (string), 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/write.ts:238-243 (registration)Local registration of createPlaylist tool within the writeTools export array, which is later imported and registered.export const writeTools = [ addToQueue, addTracksToPlaylist, createPlaylist, removeTracksFromPlaylist, ];
- src/index.ts:12-14 (registration)Main MCP server tool registration loop that registers all tools, including createPlaylist from writeTools, by calling server.tool() with name, description, schema, and handler.[...playTools, ...readTools, ...writeTools].forEach((tool) => { server.tool(tool.name, tool.description, tool.schema, tool.handler); });