# Spotify

> Spotify is a free MCP server for events and entertainment. Search, play and manage Spotify playlists and your library from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jamiew/spotify-mcp
- **MCP Registry name:** io.github.jamiew/spotify-mcp
- **Categories:** [events and entertainment](https://ai-powered.com/categories/events-and-entertainment)
- **Listing updated:** 2026-11-18

## About

This local Python server drives your own Spotify account through 48 tools, six resources and five prompts. It is a maintained fork of an earlier Spotify MCP project, and a TypeScript edition exists for hosted use.

Setup needs Python 3.12+, uv and your own Spotify developer app, with its client ID, secret and a 127.0.0.1:8888 redirect URI. Playback needs Spotify Premium and an available Connect device. First use opens a browser for authorisation, and the token is cached locally.

The design leans on large libraries: playlist reads return up to 1,000 tracks per call with a continuation offset, library writes are batched in groups of 40, and removals ask for confirmation where the client supports it. New playlists default to private. The README warns that batch writes are not atomic and that Spotify's developer-mode quotas limit how many users an app can serve.

## Features

- **48 tools:** Covers search, playback, queue, playlists and library.
- **Large playlist reads:** Pages up to 1,000 tracks per call.
- **Safe edits:** Confirmations and snapshot guards for removal and reordering.
- **Library management:** Saves tracks, albums, shows, episodes and audiobooks.
- **Listening history:** Reads top items and recently played.

## Good for

- Build a playlist from a text description
- Control playback on a Connect device
- Clean up Liked Songs in bulk
- Review top artists over a time range

## Install

### Claude Code (Terminal)

```sh
claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiew
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "spotify-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "spotify-mcp": {
      "command": "uvx",
      "args": [
        "spotify-mcp-jamiew"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": "<SPOTIFY_CLIENT_ID>",
        "SPOTIFY_CLIENT_SECRET": "<SPOTIFY_CLIENT_SECRET>",
        "SPOTIFY_REDIRECT_URI": "<SPOTIFY_REDIRECT_URI>"
      }
    }
  }
}
```

## Tools

- `get_me`: Read your profile.
- `search_music`: Search tracks, albums, artists or playlists with filters.
- `control_playback`: Play, pause, skip, seek, volume, shuffle and repeat.
- `list_devices`: List Spotify Connect devices.
- `transfer_playback`: Move playback to another device.
- `get_queue`: Read now playing and upcoming items.
- `add_to_queue`: Queue a track or episode.
- `list_playlists`: List your playlists.
- `get_playlist_tracks`: Read up to 1000 playlist tracks per call.
- `create_playlist`: Create a private playlist.
- `add_tracks_to_playlist`: Add up to 100 tracks or episodes.
- `remove_tracks_from_playlist`: Remove tracks with confirmation where supported.
- `reorder_playlist`: Move a block of tracks.
- `get_saved_tracks`: Read Liked Songs.
- `save_tracks`: Like tracks.
- `get_top_items`: Read top artists or tracks over a time range.
- `get_recently_played`: Read recently played tracks with timestamps.

## FAQ

### What do I need?

Python 3.12+, uv, a Spotify developer app and Premium for playback.

### Are new playlists public?

No, they default to private.

### Are bulk writes atomic?

No; earlier changes may remain after an error.

### Where does the token live?

Cached locally after browser authorisation.

### Is Spotify free?

Yes. Spotify is free to use.

### How do I add Spotify to Claude Code?

Run this command in your terminal: claude mcp add spotify-mcp --env SPOTIFY_CLIENT_ID='<SPOTIFY_CLIENT_ID>' --env SPOTIFY_CLIENT_SECRET='<SPOTIFY_CLIENT_SECRET>' --env SPOTIFY_REDIRECT_URI='<SPOTIFY_REDIRECT_URI>' -- uvx spotify-mcp-jamiew

### What are the best alternatives to Spotify?

The closest alternatives to Spotify are Dostuff, Skiddle, Madrid Events, Nyc Parks and Edmtrain.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Dostuff](https://ai-powered.com/mcp/dostuff): Dostuff is a freemium MCP server for events and entertainment.
- [Skiddle](https://ai-powered.com/mcp/skiddle): Skiddle is a freemium MCP server for events and entertainment.
- [Madrid Events](https://ai-powered.com/mcp/madrid-events): Madrid Events is a freemium MCP server for events and entertainment.
- [Nyc Parks](https://ai-powered.com/mcp/nyc-parks): Nyc Parks is a freemium MCP server for events and entertainment.
- [Edmtrain](https://ai-powered.com/mcp/edmtrain): Edmtrain is a freemium MCP server for events and entertainment.
- [Countdowns Online MCP](https://ai-powered.com/mcp/countdowns-online-mcp-2): Countdowns Online MCP is an open-source MCP server for events and entertainment.
- [Luma](https://ai-powered.com/mcp/luma): Luma is a freemium MCP server for events and entertainment.
- [Eventbrite](https://ai-powered.com/mcp/eventbrite): Eventbrite is a freemium MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/spotify-2
