MCP Server For Spotify

🚀 Spotify MCP Server

This MCP server integrates with the Spotify API, allowing you to manage and create playlists via Claude.

✨ Features

• Search for tracks, artists, and albums.
• Create and modify playlists.
• Browse user playlists.
• Get recommendations based on tracks, artists, and genres.

📦 Installation

Authentication Setup

1. Create a Spotify application in the Spotify Developer Dashboard.
2. Set the redirect URI to http://localhost:8888/callback.
3. Use the included authentication application to obtain your refresh token:

# Navigate to the auth-app directory
cd auth-app

# Install dependencies
npm install

# Run the authentication application
npm start

4. Follow the instructions in your browser to authorize and obtain your refresh token.
5. Set the required environment variables:

export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
export SPOTIFY_REFRESH_TOKEN="your-refresh-token"

Running the Server

After setting up the environment variables, you can start the server with the following commands:

# From the root directory
npm install
npm run build
node dist/index.js

Using Docker

You can also build and run the server using Docker:

# Build the Docker image
podman build -t mcp/spotify -f src/spotify/Dockerfile .

# Run the container with environment variables
podman run -e SPOTIFY_CLIENT_ID="your-client-id" \
  -e SPOTIFY_CLIENT_SECRET="your-client-secret" \
  -e SPOTIFY_REFRESH_TOKEN="your-refresh-token" \
  mcp/spotify

💻 Usage Examples

Using with Claude

Add the following to your server configuration:

{
  "mcpServers": {
    "spotify": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SPOTIFY_CLIENT_ID=your-client-id",
        "-e",
        "SPOTIFY_CLIENT_SECRET=your-client-secret",
        "-e",
        "SPOTIFY_REFRESH_TOKEN=your-refresh-token",
        "mcp/spotify"
      ]
    }
  }
}

Prompt Usage

Once the MCP server is running, Claude can use it to:

1. Search for music on Spotify.
2. Create playlists based on themes or genres.
3. Add tracks to playlists.
4. Browse your existing playlists.
5. Get recommendations based on your music preferences.

Simply ask Claude to create a playlist or find music, and it will use the appropriate Spotify API tools through the MCP server.