remove_tracks
Remove tracks from your Spotify library to maintain a curated collection of current favorites. Clean up outdated music, remove accidental saves, and update your library to reflect changing musical tastes.
Instructions
Remove tracks from the user's personal library to maintain a curated collection of current favorites.
🎯 USE CASES: • Clean up library by removing tracks you no longer enjoy • Maintain relevance in your personal music collection • Remove accidental saves and unwanted additions • Update library to reflect changing musical tastes • Organize library by removing outdated preferences
📝 WHAT IT RETURNS: • Confirmation of successful track removals • Updated library count after removals • List of successfully removed tracks • Error details for tracks that couldn't be removed • Final library state after cleanup operation
🔍 EXAMPLES: • "Remove 'Old Song' from my liked tracks" • "Unlike these 3 tracks I no longer enjoy" • "Remove track IDs: 1BxfuPKGuaTgP6aM0NMpti, 4LRPiXqCikLlN15c3yImP7" • "Clean up my library by removing outdated music"
🧹 LIBRARY MAINTENANCE: • Keeps collection current and relevant • Reflects evolving musical tastes • Maintains quality over quantity approach • Perfect for regular library cleanup sessions • Essential for curated collection management
💡 CURATION TIPS: • Regular cleanup keeps library fresh • Remove tracks that no longer resonate • Consider seasonal relevance for cleanup timing • Use bulk removals for major library overhauls • Keep library aligned with current preferences
⚠️ REQUIREMENTS: • Valid Spotify access token with user-library-modify scope • Track IDs must match exactly for successful removal • Maximum 50 tracks can be removed per request
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Spotify access token for authentication | |
| trackIds | Yes | Array of Spotify track IDs to remove |
Implementation Reference
- src/mcp/tools/tracks.ts:258-261 (handler)The handler function for the 'remove_tracks' tool that extracts arguments and calls SpotifyService.removeTracks
handler: async (args: any, spotifyService: SpotifyService) => { const { token, trackIds } = args; return await spotifyService.removeTracks(token, trackIds); }, - src/mcp/tools/tracks.ts:252-257 (schema)Input schema validation for the 'remove_tracks' tool defining token and trackIds parameters
schema: createSchema({ token: commonSchemas.token(), trackIds: z .array(z.string()) .describe("Array of Spotify track IDs to remove"), }), - src/mcp/tools/index.ts:22-36 (registration)Registration of all tools by spreading trackTools (containing 'remove_tracks') into the central allTools registry used for MCP tool listing and execution
export const allTools: ToolsRegistry = { ...albumTools, ...artistTools, ...trackTools, ...playlistTools, ...playbackTools, ...userTools, ...searchTools, }; - src/spotify.ts:450-459 (helper)Core helper method in SpotifyService that performs the actual API call to remove tracks from user's library via DELETE /me/tracks
async removeTracks( token: string, trackIds: string | string[] ): Promise<void> { const ids = Array.isArray(trackIds) ? trackIds.map((id) => this.extractId(id)) : [this.extractId(trackIds)]; const params = { ids: ids.join(",") }; return await this.makeRequest<void>("me/tracks", token, params, "DELETE"); }