mcpField
M
MCP Server for Spotify

MCP Server for Spotify

Local
github.com/richbai90Media & Design1Updated 82w ago
Repository

About MCP Server for Spotify

MCP Server for Spotify connects Claude to the Spotify API for music search, playlist management, and recommendations. It is intended for people who want to work with Spotify through an AI assistant.

Key features

  1. 01Search tracks, artists, and albums
  2. 02Create and modify playlists
  3. 03Browse user playlists
  4. 04Get recommendations by track, artist, or genre

Use cases

  1. 01Build playlists around themes or genres
  2. 02Find tracks, artists, or albums
  3. 03Explore existing playlists and get music recommendations

MCP support

This MCP server exposes Spotify search, playlist management, and recommendation capabilities to Claude and other MCP clients. Authentication uses Spotify Developer credentials and a refresh token.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Server for Spotify

This MCP server integrates with the Spotify API to allow you to manage and create playlists through Claude.

Features

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

Authentication Setup

  1. Create a Spotify App in the Spotify Developer Dashboard
  2. Set the redirect URI to http://localhost:8888/callback
  3. Use the included auth app to get your refresh token:
# Go to the auth-app directory
cd auth-app

# Install dependencies
npm install

# Run the auth app
npm start

  1. Follow the instructions in the browser to authorize and obtain your refresh token

  2. 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

Once you have the required environment variables, you can run the server:

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

Docker Usage

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 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"
      ]
    }
  }
}

Prompting

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

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.