Spotify MCP Server
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: 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.gitAgregue 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
uvesté 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-mcpAl 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 syncDistribuciones de paquetes de compilación:
uv buildEsto creará distribuciones de origen y de rueda en el directorio dist/ .
Publicar en PyPI:
uv publishNota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:
Token:
--tokenoUV_PUBLISH_TOKENO nombre de usuario/contraseña:
--username/UV_PUBLISH_USERNAMEy--password/UV_PUBLISH_PASSWORD
Available Tools
5 toolsSpotifyGetInfoA
Get detailed information about a Spotify item (track, album, artist, or playlist).
Inputs: item_uri (required).
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.
Inputs: action (required), num_skips, spotify_uri.
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.
Inputs: action (required), description, name, playlist_id, +1 more.
SpotifyQueueB
Manage the playback queue - get the queue or add tracks.
Inputs: action (required), track_id.
SpotifySearchB
Search for tracks, albums, artists, or playlists on Spotify.
Inputs: query (required), limit, qtype.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: SpotifyGetInfo retrieves metadata, SpotifyPlayback handles real-time playback control, SpotifyPlaylist manages playlist content and details, SpotifyQueue manages the playback queue, and SpotifySearch performs searches. There is no overlap in functionality that would cause confusion.
All tool names follow a consistent 'Spotify' prefix with a descriptive noun or verb-noun pattern (e.g., SpotifyGetInfo, SpotifyPlayback, SpotifyPlaylist, SpotifyQueue, SpotifySearch). This uniformity makes the tool set predictable and easy to navigate.
With 5 tools, the server is well-scoped for managing Spotify interactions, covering key areas like playback, playlists, search, queue, and general info. Each tool earns its place without feeling bloated or insufficient for the domain.
The tool set provides comprehensive coverage for core Spotify operations, including CRUD for playlists, playback control, search, and queue management. A minor gap is the lack of user profile or library management tools (e.g., managing saved tracks or albums), but agents can still handle most common workflows effectively.
Maintenance
Related MCP Connectors
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Related MCP Servers
- AlicenseBqualityBmaintenanceConnects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.48457 PyPI13MIT
- FlicenseAqualityDmaintenanceConnects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.4-
- FlicenseNot gradedqualityDmaintenanceConnects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.1-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to control Spotify features including playback control, playlist management, search, and accessing user's listening history and preferences through the Spotify API.1ISC