addToQueue
Add tracks, albums, artists, or playlists to your Spotify playback queue using Spotify URIs or IDs. Specify a device to control where music is queued.
Instructions
Adds a track, album, artist or playlist to the playback queue
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uri | No | The Spotify URI to play (overrides type and id) | |
| type | No | The type of item to play | |
| id | No | The Spotify ID of the item to play | |
| deviceId | No | The Spotify device ID to add the track to |
Implementation Reference
- src/write.ts:138-173 (handler)The async handler function that implements the logic for adding a Spotify item (track, album, artist, or playlist) to the playback queue. It constructs the URI if needed, validates inputs, calls the Spotify API via handleSpotifyRequest, and returns success or error messages.
handler: async (args) => { const { uri, type, id, deviceId } = args; let spotifyUri = uri; if (!spotifyUri && type && id) { spotifyUri = `spotify:${type}:${id}`; } if (!spotifyUri) { return { content: [ { type: 'text', text: 'Error: Must provide either a URI or both a type and ID', isError: true, }, ], }; } await handleSpotifyRequest(async (spotifyApi) => { await spotifyApi.player.addItemToPlaybackQueue( spotifyUri, deviceId || '', ); }); return { content: [ { type: 'text', text: `Added item ${spotifyUri} to queue`, }, ], }; }, - src/write.ts:123-137 (schema)Zod input schema for the addToQueue tool, defining optional parameters: uri, type, id, and deviceId with descriptions.
schema: { uri: z .string() .optional() .describe('The Spotify URI to play (overrides type and id)'), type: z .enum(['track', 'album', 'artist', 'playlist']) .optional() .describe('The type of item to play'), id: z.string().optional().describe('The Spotify ID of the item to play'), deviceId: z .string() .optional() .describe('The Spotify device ID to add the track to'), }, - src/write.ts:238-243 (registration)The addToQueue tool is registered by inclusion in the exported writeTools array.
export const writeTools = [ addToQueue, addTracksToPlaylist, createPlaylist, removeTracksFromPlaylist, ]; - src/index.ts:12-14 (registration)All tools from writeTools (including addToQueue) are registered on the MCP server using server.tool() in a loop.
[...playTools, ...readTools, ...writeTools].forEach((tool) => { server.tool(tool.name, tool.description, tool.schema, tool.handler); });