mcp-spotify-cli
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GROQ_API_KEY | No | API key for Groq LLM provider (required for agent). | |
| GEMINI_API_KEY | No | API key for Google Gemini LLM provider (required for agent). | |
| OPENAI_API_KEY | No | API key for OpenAI LLM provider (required for agent). | |
| SPOTIPY_CLIENT_ID | Yes | Your Spotify app Client ID. | |
| SPOTIPY_REDIRECT_URI | No | Redirect URI for Spotify OAuth. Defaults to http://127.0.0.1:8080. | http://127.0.0.1:8080 |
| SPOTIPY_CLIENT_SECRET | Yes | Your Spotify app Client Secret. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_current_trackA | Devuelve la canción que está sonando ahora mismo. |
| list_devicesB | Lista los dispositivos Spotify disponibles. |
| search_trackC | Busca una canción en Spotify y devuelve el URI para reproducirla. |
| search_playlistC | Busca una playlist en Spotify y devuelve el URI para reproducirla. |
| get_my_playlistsA | Devuelve las playlists del usuario autenticado con sus URIs. Usá siempre esta herramienta primero si el usuario pide reproducir 'mi playlist' o 'mis playlists'. |
| playA | Reproduce una canción o playlist dado su URI de Spotify. Si no se pasa URI, reanuda la reproducción actual. Ejemplos de URI: spotify:track:xxx o spotify:playlist:xxx |
| pauseB | Pausa la reproducción. |
| next_trackA | Salta a la siguiente canción y devuelve el nombre del tema. |
| previous_trackA | Vuelve a la canción anterior y devuelve el nombre del tema. |
| set_volumeC | Ajusta el volumen. Valor entre 0 y 100. |
| set_shuffleC | Activa o desactiva el modo aleatorio (shuffle). |
| set_repeatA | Cambia el modo de repetición. Valores válidos: 'off', 'track', 'context'
|
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct resource or playback action: playback state, devices, track search, playlist search, user playlists, and specific playback controls. There is no meaningful overlap between search_track/search_playlist or between play/pause/next/previous.
Names are consistently snake_case and mostly follow verb_noun or action_noun patterns (get_current_track, list_devices, set_volume). Minor deviations exist with bare verbs play/pause and next_track/previous_track, but the set remains predictable.
Twelve tools is well-scoped for Spotify playback control, with each tool covering a distinct operation. The count is neither thin nor excessive for the domain.
Core playback is covered: play, pause, skip, volume, shuffle, repeat, current track, search, and playlists. However, notable gaps remain: no device transfer/selection despite list_devices, no seek/position control, no queue management, and no playback state beyond the current track.