getQueue
Retrieve the currently playing track and upcoming items in your Spotify queue to manage playback order and preview upcoming music.
Instructions
Get a list of the currently playing track and the next items in your Spotify queue
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of upcoming items to show (1-50) |
Implementation Reference
- src/read.ts:466-543 (handler)The handler function for 'getQueue' tool. It fetches the user's Spotify queue using `spotifyApi.player.getUsersQueue()`, formats the currently playing track (if any) and the next up to 'limit' (default 10) items in the queue, handling errors and returning formatted text content.handler: async (args, _extra: SpotifyHandlerExtra) => { const { limit = 10 } = args; try { const queue = await handleSpotifyRequest(async (spotifyApi) => { return await spotifyApi.player.getUsersQueue(); }); const current = (queue as any)?.currently_playing; const upcoming = ((queue as any)?.queue ?? []) as any[]; const header = '# Spotify Queue\n\n'; let currentText = 'Nothing is currently playing'; if (current) { const name = current?.name ?? 'Unknown'; const artists = Array.isArray(current?.artists) ? (current.artists as Array<{ name: string }>) .map((a) => a.name) .join(', ') : 'Unknown'; const duration = typeof current?.duration_ms === 'number' ? formatDuration(current.duration_ms) : 'Unknown'; currentText = `Currently Playing: "${name}" by ${artists} (${duration})`; } if (upcoming.length === 0) { return { content: [ { type: 'text', text: `${header}${currentText}\n\nNo upcoming items in the queue`, }, ], }; } const toShow = upcoming.slice(0, limit); const formatted = toShow .map((track, i) => { const name = track?.name ?? 'Unknown'; const artists = Array.isArray(track?.artists) ? (track.artists as Array<{ name: string }>) .map((a) => a.name) .join(', ') : 'Unknown'; const duration = typeof track?.duration_ms === 'number' ? formatDuration(track.duration_ms) : 'Unknown'; const id = track?.id ?? 'Unknown'; return `${i + 1}. "${name}" by ${artists} (${duration}) - ID: ${id}`; }) .join('\n'); return { content: [ { type: 'text', text: `${header}${currentText}\n\nNext ${toShow.length} in queue:\n\n${formatted}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error fetching queue: ${ error instanceof Error ? error.message : String(error) }`, }, ], }; } },
- src/read.ts:458-464 (schema)Input schema for 'getQueue' tool using Zod: optional 'limit' number between 1 and 50.schema: { limit: z .number() .min(1) .max(50) .optional() .describe('Maximum number of upcoming items to show (1-50)'),
- src/read.ts:603-612 (registration)Registration of 'getQueue' tool in the exported 'readTools' array, likely used to register all read-related tools in the MCP server.export const readTools = [ searchSpotify, getNowPlaying, getMyPlaylists, getPlaylistTracks, getRecentlyPlayed, getUsersSavedTracks, getQueue, getAvailableDevices, ];
- src/read.ts:452-544 (handler)Complete tool definition for 'getQueue', including type annotation, name, description, schema, and handler.const getQueue: tool<{ limit: z.ZodOptional<z.ZodNumber>; }> = { name: 'getQueue', description: 'Get a list of the currently playing track and the next items in your Spotify queue', schema: { limit: z .number() .min(1) .max(50) .optional() .describe('Maximum number of upcoming items to show (1-50)'), }, handler: async (args, _extra: SpotifyHandlerExtra) => { const { limit = 10 } = args; try { const queue = await handleSpotifyRequest(async (spotifyApi) => { return await spotifyApi.player.getUsersQueue(); }); const current = (queue as any)?.currently_playing; const upcoming = ((queue as any)?.queue ?? []) as any[]; const header = '# Spotify Queue\n\n'; let currentText = 'Nothing is currently playing'; if (current) { const name = current?.name ?? 'Unknown'; const artists = Array.isArray(current?.artists) ? (current.artists as Array<{ name: string }>) .map((a) => a.name) .join(', ') : 'Unknown'; const duration = typeof current?.duration_ms === 'number' ? formatDuration(current.duration_ms) : 'Unknown'; currentText = `Currently Playing: "${name}" by ${artists} (${duration})`; } if (upcoming.length === 0) { return { content: [ { type: 'text', text: `${header}${currentText}\n\nNo upcoming items in the queue`, }, ], }; } const toShow = upcoming.slice(0, limit); const formatted = toShow .map((track, i) => { const name = track?.name ?? 'Unknown'; const artists = Array.isArray(track?.artists) ? (track.artists as Array<{ name: string }>) .map((a) => a.name) .join(', ') : 'Unknown'; const duration = typeof track?.duration_ms === 'number' ? formatDuration(track.duration_ms) : 'Unknown'; const id = track?.id ?? 'Unknown'; return `${i + 1}. "${name}" by ${artists} (${duration}) - ID: ${id}`; }) .join('\n'); return { content: [ { type: 'text', text: `${header}${currentText}\n\nNext ${toShow.length} in queue:\n\n${formatted}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error fetching queue: ${ error instanceof Error ? error.message : String(error) }`, }, ], }; } }, };