mcp-registry/spotify-mcp-server

    ==================
      
       /// MCP ///
      /// SPO ///
        
    ==================
        
    [server:online]
    [protocol:ready]

spotify-mcp-server

by marcelmarais

Light-weight Model Context Protocol (MCP) server that lets AI assistants (Cursor, Claude, etc.) control Spotify playback and manage playlists.

90
21
Open Source

Installation

1. Clone the repo
git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
2. Install dependencies
npm install # or pnpm install / yarn
3. Create environment file
cp .env.example .env
# open .env and set:
# SPOTIFY_CLIENT_ID=<your-spotify-app-id>
# SPOTIFY_CLIENT_SECRET=<your-spotify-app-secret>
# MCP_API_KEY=<optional key required by your deployment>
# PORT=3000 (or any free port)
4. Build TypeScript → JavaScript
npm run build # expects a "build" script in package.json (e.g. tsc)
# –or – run in dev-watch mode
npm run dev # usually wraps ts-node-dev / nodemon
5. Start the server
npm start # or: node dist/index.js
# server will listen on http://localhost:$PORT
Docker (optional)
------------------------------------------------
# Build image
docker build -t spotify-mcp-server .
# Run container
docker run -d -p 3000:3000 --env-file .env spotify-mcp-server

Documentation

# Transform Your Coding Sessions: Spotify Control Through Augment Code

Tired of breaking your coding flow to switch songs or find the perfect playlist? The **Spotify MCP Server** turns Augment Code into your personal DJ, letting you control your entire Spotify experience without ever leaving your editor. Now you can ask Augment to "play some focus music for debugging" or "create a playlist with tracks similar to what I'm currently listening to" and watch as your coding environment becomes a seamless productivity hub.

## Seamless Music Integration for Focused Development

This MCP server transforms Augment Code from a coding assistant into a complete workspace orchestrator. With 12 powerful Spotify tools at your disposal, Augment can now **search for tracks by mood or energy level**, **automatically create coding playlists**, and **manage playback based on your current task**. Whether you're deep in a debugging session and need to pause distractions, or starting a creative coding sprint and want energizing music, Augment can handle it all through natural language commands. The server provides both read operations (checking what's playing, browsing playlists) and full control actions (play, pause, skip, queue management), making your music as responsive as your code.

## Real-World Productivity Scenarios

Picture this: You're working on a complex algorithm and tell Augment *"Play some instrumental focus music and pause notifications"* - it finds the perfect coding playlist and starts it playing. Later, during a code review session, you say *"Create a playlist called 'Code Review Vibes' with mellow tracks from my recently played"* and Augment seamlessly builds it while you review pull requests. The integration supports advanced workflows like **copying tracks between playlists**, **queuing specific songs for your current coding mood**, and **automatically pausing music when you need to focus on debugging**. To get started, simply add the server to your Augment MCP configuration and authenticate with your Spotify account - then your coding environment becomes a complete productivity sanctuary where music flows as naturally as your code.
License: No license file found – treat as © proprietary/unknown
Updated 7/15/2025

Table of Contents