Spotify-Claude MCP Server
A tool that connects to the Spotify API and uses Claude as an AI assistant for enhanced music discovery and interaction.
Overview
This project integrates Claude AI with the Spotify API through a Model Control Protocol (MCP) server. It allows users to interact with their Spotify account using natural language queries processed by Claude.
Features
Currently the claude can get the Artist information using the SpotifyAPI. This can be extended for other queries, such as getting top tracks, or genres, creating playlists, or getting user profile data
Prerequisites
- Spotify Developer Account
- Spotify API credentials (Client ID and Client Secret)
- Claude Desktop
Installation
- Clone the repository:
git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP
- Install dependencies:
npm install
- Set up environment variables: Create a .env file in the root directory with the following variables:
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_ACCESS_TOKEN=access_token_obtained_from_clientId_and_clientSecret
Configuration
Register your app in the Spotify Developer Dashboard Add http://localhost:8888/callback as a Redirect URI in your Spotify app settings Copy the Client ID and Client Secret to your .env file
Usage
- Build the project
tsc -b
-
Add MCP Server configuration in Claude config file
-
Prompt Claude about the name of the artist
Tool Functions
The MCP server exposes the following function to Claude:
get_artist(name): Retrieves information about an artist
Example Interactions
User: "What is the artist name?"
Claude: [Uses get_artist function] "The artist name is Pitbull."
MCP Server: Handles communication between Claude and the Spotify API Spotify API Client: Manages authentication and API requests to Spotify Claude Integration: Processes natural language and determines which functions to call