Spotify Controller MCP Server

Overview

Spotify Controller allows AI assistants to interact with your Spotify account through the Model Context Protocol (MCP). This enables natural language control of your music experience, from simple playback commands to complex playlist management.

Setup Instructions

Prerequisites

1. A Spotify account (Premium recommended for full playback control)
2. Node.js installed on your system
3. A Spotify Developer Application (instructions below)

Installation

1. Clone the repository:

   git clone https://github.com/marcelmarais/spotify-mcp-server.git
   cd spotify-mcp-server
   

2. Install dependencies:

   npm install
   

3. Create a Spotify Developer Application:

   • Go to the Spotify Developer Dashboard
   • Log in with your Spotify account
   • Click "Create an App"
   • Fill in the app name and description
   • Set the Redirect URI to http://localhost:3000/callback
   • Save your Client ID and Client Secret

4. Configure the server:

   • Copy spotify-config.example.json to spotify-config.json
   • Fill in your Spotify Client ID and Client Secret
   • Adjust other settings as needed

5. Start the server:

   npm start
   

6. Complete the authentication process:

   • The server will provide a URL to authorize the application
   • Open the URL in your browser
   • Log in to Spotify and authorize the application
   • You'll be redirected to the callback URL
   • The server will automatically capture the authorization code and exchange it for access tokens

Integrating with AI Assistants

Claude Desktop

Add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "spotify": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/spotify-mcp-server"
    }
  }
}

Cursor

Add the following to your Cursor configuration:

{
  "mcpServers": {
    "spotify": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/spotify-mcp-server"
    }
  }
}

VSCode (Cline)

Add the following to your Cline configuration:

{
  "mcpServers": {
    "spotify": {
      "command": "npm",
      "args": ["start"],
      "cwd": "/path/to/spotify-mcp-server"
    }
  }
}

Usage Examples

Once set up, you can interact with Spotify through your AI assistant using natural language:

• "Play the latest album by Taylor Swift"
• "Create a workout playlist with upbeat songs"
• "Skip to the next track"
• "Pause my music"
• "Show me my playlists"
• "Add this song to my favorites playlist"

The AI assistant will use the appropriate tools to fulfill your requests, allowing for a seamless music control experience.