en es ja ko zh

Spotify MCP Server

Name: Spotify MCP Server
Author: varunneal

by varunneal

Overview Schema Source Related Servers Discussions Admin

Python

Local

Servidor MCP de spotify-mcp

Proyecto MCP para conectar a Claude con Spotify. Desarrollado con la API de spotipy-dev .

Características

Iniciar, pausar y omitir la reproducción
Buscar pistas/álbumes/artistas/listas de reproducción
Obtener información sobre una pista/álbum/artista/lista de reproducción
Administrar la cola de Spotify
Administrar, crear y actualizar listas de reproducción

Related MCP server: Vulpes Spotify MCP Server

Manifestación

Asegúrese de activar el audio

Configuración

Obtener claves API de Spotify

Crea una cuenta en developer.spotify.com . Ve al panel de control . Crea una aplicación con el redirect_uri http://127.0.0.1:8080/callback . Puedes elegir el puerto que quieras, pero debes usar http y una dirección de bucle invertido explícita (IPv4 o IPv6).

Consulte aquí para obtener más información y solución de problemas. Es posible que tenga que reiniciar su entorno MCP (por ejemplo, Claude Desktop) una o dos veces para que funcione.

Ejecutar este proyecto localmente

Este proyecto aún no está configurado para entornos efímeros (p. ej., uso de uvx ). Ejecútelo localmente clonando este repositorio.

git clone https://github.com/varunneal/spotify-mcp.git

Agregue esta herramienta como servidor mcp.

Escritorio de Claude en MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Escritorio de Claude en Windows: %APPDATA%/Claude/claude_desktop_config.json

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

Solución de problemas

Si no consigues que este MCP funcione, abre un problema. Aquí tienes algunos consejos:

Asegúrate de que uv esté actualizado. Recomiendo la versión >=0.54 .
Asegúrese de que Claude tenga permisos de ejecución para el proyecto: chmod -R 755 .
Asegúrate de tener Spotify Premium (necesario para ejecutar la API para desarrolladores).

Este MCP emitirá registros a std err (según lo especificado en la especificación del MCP). En Mac, la aplicación Claude Desktop debería emitir estos registros a ~/Library/Logs/Claude . En otras plataformas, puede encontrar los registros aquí .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

HACER

Lamentablemente, varias funciones interesantes de la API de Spotify han quedado obsoletas . La mayoría de las nuevas funciones serán relativamente menores o afectarán la salud del proyecto:

pruebas.
agregando soporte API para administrar listas de reproducción.
agregando soporte API para resultados de búsqueda paginados/listas de reproducción/álbumes.

¡Se agradecen las relaciones públicas! Gracias a @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj y otros por sus contribuciones.

Despliegue

(hacer)

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Available Tools

5 tools

SpotifyGetInfoA

Get detailed information about a Spotify item (track, album, artist, or playlist).

ParametersJSON Schema

Name	Required	Description	Default
`item_uri`	Yes	URI of the item to get information about. If 'playlist' or 'album', returns its tracks. If 'artist', returns albums and top tracks.

TDQS

A3.7/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description carries the full burden. It explains return differences by type (tracks for albums/playlists, albums/top tracks for artists), but does not specify nondestructive nature, authentication needs, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence with no wasted words. It efficiently conveys the core function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description partially compensates by specifying behavior per item type, but it does not enumerate all returned fields (e.g., metadata like name, duration). This leaves some ambiguity for a simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and already details the URI parameter's behavior. The description adds no additional meaning beyond restating the tool's purpose, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves detailed information for a Spotify item (track, album, artist, or playlist), differentiating it from siblings like SpotifySearch (which searches by query) and SpotifyPlayback/Queue (which control playback).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the schema requiring a URI, but the description does not explicitly state when to use this tool over siblings or provide exclusions. An agent must infer context from sibling names.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

SpotifyPlaybackB

Manages the current playback with the following actions: - get: Get information about user's current track. - start: Starts playing new item or resumes current playback if called with no uri. - pause: Pauses current playback. - skip: Skips current track.

ParametersJSON Schema

Name	Required	Description
`action`	Yes	Action to perform: 'get', 'start', 'pause' or 'skip'.
`spotify_uri`	No	Spotify uri of item to play for 'start' action. If omitted, resumes current playback.
`num_skips`	No	Number of tracks to skip for `skip` action.

TDQS

B3.4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the transparency burden. It discloses basic behaviors like 'resumes current playback' for start and 'skips current track' for skip, but omits details on permissions, rate limits, error states (e.g., no active device), and whether get returns current track info or just status.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: one introductory sentence followed by a bullet list of actions. Every piece of information is front-loaded and relevant. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (multi-action playback control) and lack of output schema or annotations, the description is incomplete. It fails to mention prerequisites like an active Spotify device, account type requirements, or error handling. Important operational context is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The tool description does not add significant meaning beyond the schema's parameter descriptions; it repeats the same action list. For example, 'num_skips' and 'spotify_uri' are already explained in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool manages current playback and lists four specific actions (get, start, pause, skip). This is a specific verb+resource with clear action breakdown, distinguishing it from sibling tools like SpotifyGetInfo (which likely retrieves broader info) and SpotifyQueue (queue management).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, nor does it mention prerequisites (e.g., active device) or when not to use it (e.g., if user lacks Premium). Usage context is entirely implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

SpotifyPlaylistC

Manage Spotify playlists. - get: Get a list of user's playlists. - get_tracks: Get tracks in a specific playlist. - add_tracks: Add tracks to a specific playlist. - remove_tracks: Remove tracks from a specific playlist. - change_details: Change details of a specific playlist. - create: Create a new playlist.

ParametersJSON Schema

Name	Required	Description
`action`	Yes	Action to perform: 'get', 'get_tracks', 'add_tracks', 'remove_tracks', 'change_details', 'create'.
`playlist_id`	No	ID of the playlist to manage.
`track_ids`	No	List of track IDs to add/remove.
`name`	No	Name for the playlist (required for create and change_details).
`description`	No	Description for the playlist.
`public`	No	Whether the playlist should be public (for create action).

TDQS

C2.6/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it lists six actions and their basic purposes, it doesn't disclose critical behavioral traits: authentication requirements, rate limits, whether operations are destructive, what happens on errors, or what the return values look like. For a multi-action tool with potential write operations (add, remove, change, create), this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently structured with a brief overview followed by a bulleted list of actions. Each bullet is concise and to the point. However, the opening 'Manage Spotify playlists' is redundant with the tool name and could be eliminated, and the bullet format while clear isn't the most natural language for AI comprehension.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex multi-action tool with six parameters and no annotations or output schema, the description is incomplete. It doesn't explain return values, error conditions, authentication requirements, or the relationships between actions. The tool handles both read and write operations, but the description provides minimal behavioral context, making it inadequate for safe and effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all six parameters thoroughly. The description doesn't add any meaningful parameter semantics beyond what's in the schema - it simply lists action names without explaining parameter dependencies or constraints. The baseline of 3 is appropriate when the schema does all the parameter documentation work.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Manage Spotify playlists' which is a vague purpose that doesn't specify what management entails. It then lists six sub-actions with brief explanations, but the overall purpose remains broad. While it distinguishes from sibling tools by focusing on playlists rather than search, playback, or queue operations, the verb 'manage' is too generic for clear understanding.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided about when to use this tool versus the sibling tools (SpotifyGetInfo, SpotifyPlayback, SpotifyQueue, SpotifySearch). The description lists six actions but doesn't explain when each should be used relative to each other or to other tools. There's no mention of prerequisites, authentication requirements, or contextual factors that would guide selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

SpotifyQueueB

Manage the playback queue - get the queue or add tracks.

ParametersJSON Schema

Name	Required	Description	Default
`action`	Yes	Action to perform: 'add' or 'get'.
`track_id`	No	Track ID to add to queue (required for add action)

TDQS

B3.4/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description bears full responsibility. It fails to disclose behavior such as whether adding a track requires an active device, if the queue is appended or overwritten, or what errors occur. Minimal behavioral detail beyond the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single, concise sentence that immediately communicates the tool's purpose. No superfluous words, front-loads the resource and actions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with two parameters and two actions, the description adequately covers purpose. It lacks details on return values or error cases but is sufficient for basic usage given no output schema and limited complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with parameter descriptions. The description adds marginal value by linking 'add tracks' to the action parameter and implying track_id for add. Baseline score is appropriate as schema handles semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool manages the playback queue with two specific actions: get or add tracks. It distinguishes itself from sibling tools like SpotifyPlayback by focusing on queue management.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like SpotifyPlayback for control operations. The description simply lists actions without context on prerequisites or typical use cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

SpotifySearchB

Search for tracks, albums, artists, or playlists on Spotify.

ParametersJSON Schema

Name	Required	Description	Default
`query`	Yes	query term
`qtype`	No	Type of items to search for (track, album, artist, playlist, or comma-separated combination)	track
`limit`	No	Maximum number of items to return

TDQS

B3.4/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries burden. It mentions search types and parameters but omits behavior like response structure, pagination, error handling, auth needs, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single clear sentence, front-loaded with action verb. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 3 parameters, no output schema, and no annotations, the description is too brief. Lacks guidance on output format, pagination, or effective usage compared to sibling tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema has 100% coverage with descriptions for all 3 parameters. Description adds minimal context beyond schema (e.g., hinting at qtype values already documented). Baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states it searches for tracks, albums, artists, or playlists on Spotify. Distinct from sibling tools like SpotifyGetInfo (specific item info), SpotifyPlayback (playback control), SpotifyQueue (queue management).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description implies usage for searching Spotify content, but no explicit when-to-use vs alternatives, no when-not or exclusions provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

5 tool updatesv1.0.0Jan 2, 2026
- First observedSpotifyGetInfo
- First observedSpotifyPlayback
- First observedSpotifyPlaylist
- First observedSpotifyQueue
- First observedSpotifySearch

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.3/5.0

Scored 2026-04-18 11:30 across 5 tools

Disambiguation4/5

Most tools have distinct purposes: GetInfo for metadata, Playback for player control, Playlist for playlist management, Queue for queue operations, and Search for finding content. However, there is some potential overlap between GetInfo and Search, as both can retrieve item details, though GetInfo is more specific to known items while Search is for discovery.

Naming Consistency4/5

Tool names follow a consistent 'Spotify' prefix and descriptive noun-based naming (e.g., SpotifyPlayback, SpotifyPlaylist). The internal actions within tools (like get, start, pause) are also consistent. A minor deviation is that some tools use underscores in action names (e.g., get_tracks), while others do not, but overall the pattern is clear and readable.

Tool Count5/5

With 5 tools, the server is well-scoped for Spotify integration, covering key areas like playback control, playlist management, search, and queue handling. Each tool serves a distinct purpose without being overly broad or too narrow, making it manageable and functional for typical agent tasks.

Completeness4/5

The tool set covers core Spotify functionalities: playback control, playlist CRUD operations, search, and queue management. Minor gaps include lack of user profile management (e.g., get user info) or more advanced features like recommendations, but the essential workflows for playing music and managing content are well-supported.

Maintenance

ActivityInactive

ResponsivenessUnresponsive

Resources

GitHub Repository

Need Help?

Reddit Discussion

Related Servers

Related MCP Connectors

Remote Desktop CommanderOAuth
app.desktopcommander
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Shell Access OS Automation
2145
Lacuna Music A
io.github.JOYLINK-LTD
Generate AI music via the Lacuna Music API from MCP clients like Claude Desktop & Code.
AI & Machine Learning Audio Processing
315
LeadFoxConnectOAuth
io.github.LeadFox-Shay
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Marketing CRM
2
WHOOP — MissingMCPOAuth
com.missingmcp
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
Health & Wellness Fitness Tracking
213

Related MCP Servers

Spotify MCP Server
Entertainment & Media App Automation
Naunau75
F
license
Not graded
quality
D
maintenance
Connects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.
Updated 2 years ago (2025-04-02 09:27 UTC)
1
-
Vulpes Spotify MCP Server
Entertainment & Media Agent Orchestration
ejfox
F
license
Not graded
quality
D
maintenance
A Model Context Protocol server that enables AI assistants like Claude to interact with Spotify, allowing them to search for tracks, control playback, and manage playlists.
Updated a year ago (2025-05-29 02:07 UTC)
1
-
Spotify MCP Server
Entertainment & Media API Testing
g2dgaming
F
license
A
quality
D
maintenance
Connects Claude with Spotify, allowing users to control playback, search for music, get track/artist information, and manage the queue via the Spotify API.
Updated a year ago (2025-06-02 17:27 UTC)
5
1
-
Spotify MCP Server
Entertainment & Media App Automation Content Management Systems
latiftplgu
F
license
A
quality
D
maintenance
A Model Context Protocol server that enables AI assistants like Claude Desktop to interact with Spotify's music streaming service, supporting playback control, playlist management, music search, and user profile access.
Updated a year ago (2025-07-30 16:45 UTC)
41
2
-

Servidor MCP de spotify-mcp

Características

Manifestación

Configuración

Obtener claves API de Spotify

Ejecutar este proyecto localmente

Solución de problemas

HACER

Despliegue

Construcción y publicación

Available Tools

Tool Schema Changelog

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches