Spotify MCP Server

Spotify MCP Server is a dual-mode tool server for controlling Spotify through your terminal or via AI assistants like Claude or ChatGPT.

Built in Python using spotipy, aiohttp, and rich, it supports both real-time manual use and seamless AI integration.

Supported Features

Depending on whether the Spotify account is free or premium, the available features differ

Related MCP server: Spotify MCP Server

Modes of Operation

1. Manual Mode (CLI)

python server.py --mode=manual

Launches an animated terminal UI to control your Spotify account without using the app.

2. AI Mode (Claude / ChatGPT / LangChain)

python server.py --mode=ai

Enables MCP tool server mode, allowing an AI agent to send structured tool calls and control your playback.

Installation & Setup

Requirements

• Python 3.9+

• Spotify Developer credentials (Client ID, Secret)

Install Dependencies

pip install -r requirements.txt

Configure Environment

Create a .env file in your root directory:

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:8888/callback

Spotify Developer Dashboard

Project Structure

spotipy-mcp-server/
├── server.py         # Main CLI + AI server
├── main.py           # Interactive terminal interface
├── requirements.txt  # Dependencies
├── .gitignore
├── README.md
└── .env              # (ignored)

Commands

License

This project is open source and dual-licensed:

• MIT License — opensource.org/license/mit

• Apache 2.0 License — apache.org/licenses/LICENSE-2.0

Use it freely with attribution. Choose the license that fits your use case best.