selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
mcp-spotify-player logo

Self-host mcp-spotify-player

v0.2.0

MCP server for controlling Spotify from AI assistants

BetaOpen SourceMIT
GitHub
Install
Updatedlast year
LanguagePython
Setup difficultyModerate
Stars
22
Requires
Python 3.9+, Spotify Web API
Install with Linux

What is mcp-spotify-player?

MCP Spotify Player is a Python-based MCP server that enables AI assistants such as Claude Desktop, Cursor, and Void to control Spotify through natural language. It provides playback control (play, pause, skip, volume, repeat), search for tracks, artists, albums, and playlists, device management, and playlist operations (create, edit, add or remove tracks). The server runs as a stdio process launched by the MCP client and uses Spotify's Web API with OAuth PKCE authentication. Users need a Spotify Premium account and must create a Spotify Developer application for credentials. Tokens are stored locally in a configurable path. The project is licensed under MIT and requires Python 3.9+.

Should you self-host mcp-spotify-player?

mcp-spotify-player scores 35/100 on selfhost.directory (how scoring works) and ranks #105 of 120 in AI Assistant. It has 22 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 957 stars). It scores higher overall, so compare the two before you pick. See mcp-spotify-player vs hermes-agent side by side.

Features

  • Device Management
  • MCP stdio server
  • OAuth PKCE Authentication
  • Playback control
  • Playlist Management
  • Python API
  • Search & Discovery

mcp-spotify-player README

How to install mcp-spotify-player

Install mcp-spotify-player with Linux

Claude Desktop installed, Python available at specified path
Environment variables
SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET, SPOTIFY_REDIRECT_URI

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "spotify-player": {
      "command": "C:/path/to/python/distribution/python.exe",
      "args": [
        "-m",
        "mcp_spotify_player"
      ],
      "cwd": "C:/path/to/cloned/repo/mcp-spotify-player",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8000/auth/callback"
      }
    }
  }
}

macOS/Linux (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "spotify-player": {
      "command": "/path/to/python/distribution/python.exe",
      "args": [
        "-m",
        "mcp_spotify_player"
      ],
      "cwd": "/path/to/cloned/repo/mcp-spotify-player",
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret",
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8000/auth/callback"
      }
    }
  }
}

Configuration file location: Windows: %APPDATA%\Claude\claude_desktop_config.json, macOS/Linux: ~/.config/claude/claude_desktop_config.json

How to configure mcp-spotify-player

  • DEBUGTrueEnable debug mode

    Enable debug mode

  • HOST127.0.0.1Server host for the local OAuth callback server

    Server host for the local OAuth callback server

  • MCP_LOG_FILEPath to log file (optional)

    Path to log file (optional)

  • MCP_LOG_LEVELLog verbosity level

    Log verbosity level

    values: DEBUG, INFO, WARNING, ERROR

  • MCP_SERVER_NAMEspotify-playerMCP server name

    MCP server name

  • MCP_SERVER_VERSION1.0.0MCP server version

    MCP server version

  • MCP_SPOTIFY_TOKENS_PATHCustom path to store OAuth tokens (defaults to ~/.config/mcp_spotify_player/tokens.json)

    Custom path to store OAuth tokens (defaults to ~/.config/mcp_spotify_player/tokens.json)

  • PORT8000Server port for the local OAuth callback server

    Server port for the local OAuth callback server

  • SPOTIFY_CLIENT_IDSpotify application client ID from Spotify Developer Dashboard

    Spotify application client ID from Spotify Developer Dashboard

  • SPOTIFY_CLIENT_SECRETSpotify application client secret from Spotify Developer Dashboard

    Spotify application client secret from Spotify Developer Dashboard

  • SPOTIFY_REDIRECT_URIhttp://127.0.0.1:8000/auth/callbackOAuth redirect URI registered in Spotify app settings

    OAuth redirect URI registered in Spotify app settings

mcp-spotify-player releases & version history

More in Audio Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…