local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables searching for tracks, viewing Spotify profiles, creating and managing playlists, adding tracks to playlists, and getting personalized music recommendations using a Spotify account.

Servidor MCP de Spotify

Un servidor simple de Protocolo de Contexto de Modelo (MCP) que te permite interactuar con Spotify a través de Claude. Este servidor permite a Claude buscar canciones, crear listas de reproducción, obtener recomendaciones y mucho más usando tu cuenta de Spotify.

Características

Buscar pistas en Spotify
Ver tu perfil de Spotify
Crear listas de reproducción
Agregar pistas a listas de reproducción
Obtenga recomendaciones musicales personalizadas

Herramientas disponibles

Nombre de la herramienta	Descripción
`set-spotify-credentials`	Establezca sus credenciales de autenticación de Spotify
`check-credentials-status`	Comprueba si tus credenciales son válidas y quién ha iniciado sesión
`search-tracks`	Busque pistas por nombre, artista o palabras clave
`get-current-user`	Obtén la información de tu perfil de Spotify
`create-playlist`	Crea una nueva lista de reproducción en tu cuenta
`add-tracks-to-playlist`	Agregar pistas a una lista de reproducción existente
`get-recommendations`	Obtenga recomendaciones basadas en pistas de semillas

Instrucciones de configuración

1. Requisitos previos

Node.js v16 o superior
npm
Una cuenta de Spotify
Una aplicación de desarrollador de Spotify registrada

2. Crea una aplicación para desarrolladores de Spotify

Ir al panel de desarrolladores de Spotify
Inicia sesión con tu cuenta de Spotify
Haga clic en "Crear una aplicación"
Complete el nombre y la descripción de la aplicación.
Agregue http://localhost:8888/callback como URI de redireccionamiento
Anote su ID de cliente y su secreto de cliente

3. Instalar el proyecto

# Clone or download the project first
cd spotify-mcp-server

# Install dependencies
npm install

4. Consigue tus tokens de Spotify

Edite el archivo spotify-auth.js para incluir su ID de cliente y secreto de cliente:

// Replace these with your Spotify app credentials
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

Luego ejecute el script de autenticación:

node spotify-auth.js

Esto hará lo siguiente:

Abra una URL en su navegador
Le solicitará que inicie sesión en Spotify
Solicita tu permiso para acceder a tu cuenta
Guarde los tokens en secrets.json

5. Construya el servidor MCP

npm run build

6. Configurar Claude Desktop

Edite su archivo de configuración de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%\Claude\claude_desktop_config.json

Agregue la siguiente configuración:

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"]
    }
  }
}

Reemplace /full/path/to/spotify-mcp-server con la ruta real al directorio de su proyecto.

7. Reinicie Claude Desktop

Cierre y vuelva a abrir Claude Desktop para cargar la nueva configuración.

Uso

Cuando inicies una conversación con Claude, primero deberás configurar tus credenciales de Spotify:

Mira tu archivo secrets.json para obtener tus credenciales
Utilice la herramienta set-spotify-credentials para autenticarse
Luego usa cualquiera de las otras herramientas de Spotify

Ejemplos de indicaciones

Configuración de credenciales

I want to connect to my Spotify account. Here are my credentials from secrets.json:

Tool: set-spotify-credentials
Parameters:
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

Comandos básicos

Revisa tu cuenta:

Can you check who I'm logged in as on Spotify?

Tool: get-current-user
Parameters: {}

Buscar pistas:

Search for songs by Weekend

Tool: search-tracks
Parameters:
{
  "query": "Taylor Swift",
  "limit": 5
}

Crear una lista de reproducción:

Create a new playlist called "My Pretty pretty girlfriend"

Tool: create-playlist
Parameters:
{
  "name": "My Pretty pretty girlfriend",
  "description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}

Tareas de varios pasos

Creando una lista de reproducción con canciones:

I want to create a workout playlist with energetic songs. First, search for some high-energy songs. Then create a playlist called "Workout Mix" and add those songs to it.

Obtener recomendaciones basadas en favoritos:

I like the song "Blinding Lights" by The Weeknd. Can you search for it, then find similar songs, and create a playlist with those recommendations?

Solución de problemas

Error: No hay token de acceso disponible : primero debe configurar sus credenciales usando la herramienta set-spotify-credentials
Errores de autenticación : Es posible que sus tokens hayan expirado. Vuelva a ejecutar el script de autenticación para obtener tokens nuevos.
Credenciales no válidas : Verifique que esté utilizando el ID de cliente y el secreto de cliente correctos

Notas

El servidor almacena las credenciales sólo en la memoria
Necesitarás establecer credenciales cada vez que inicies una nueva conversación
Si Claude Desktop se reinicia, deberá configurar las credenciales nuevamente

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Permite a Claude interactuar con Spotify buscando canciones, creando listas de reproducción, obteniendo recomendaciones y administrando su música a través de su cuenta de Spotify.

Appeared in Searches

Microsoft Outlook Application or Email Service