1. Conduid
  2. Search
  3. io.github.markswendsen-code/spotify
MCP server · Search

io.github.markswendsen-code/spotify

by · github.com/markswendsen-code/mcp-spotify

MCP server for Spotify - let AI agents control playback, search music, and manage playlists

Unclaimed last commit 7 months ago search
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.markswendsen-code/spotify

io.github.markswendsen-code/spotify is an MCP server published by markswendsen-code in the Search category: mCP server for Spotify - let AI agents control playback, search music, and manage playlists.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

Claude Code
claude mcp add io-github-markswendsen-code-spotify -- npx -y @striderlabs/mcp-spotify
npx
npx -y @striderlabs/mcp-spotify

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (3)

spotify_authAuthorize via browser (OAuth 2.0 PKCE)

Parameters not published.

spotify_logoutClear stored tokens

Parameters not published.

spotify_statusCheck connection status and logged-in account

Parameters not published.

Ask AI

✦

Ask AI about io.github.markswendsen-code/spotify

Powered by Claude · Grounded in docs

I know everything about io.github.markswendsen-code/spotify. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@striderlabs/mcp-spotify

MCP server for Spotify — let AI agents search music, control playback, and manage playlists via the Spotify Web API.

Built by Strider Labs.

Features

  • Search — Find tracks, artists, albums, and playlists
  • Playlists — View, create, and edit your playlists
  • Playback Control — Play, pause, skip, go back, set volume
  • Multi-device — List and switch between Spotify Connect devices
  • OAuth 2.0 — Secure authorization with PKCE (no client secret needed)
  • Token persistence — Tokens stored locally, auto-refreshed

Setup

1. Create a Spotify App

  1. Go to the Spotify Developer Dashboard
  2. Click Create App
  3. Set Redirect URI to: http://localhost:8888/callback
  4. Copy your Client ID

2. Install

npx @striderlabs/mcp-spotify

Or install globally:

npm install -g @striderlabs/mcp-spotify

3. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-spotify"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id_here"
      }
    }
  }
}

4. Authenticate

In Claude, call the auth tool once:

spotify_auth

A browser window will open for you to authorize access. After approving, tokens are saved locally at ~/.striderlabs/spotify/tokens.json and auto-refreshed.

Environment Variables

Variable Required Description
SPOTIFY_CLIENT_ID Yes Your Spotify app's Client ID

Tools

Authentication

Tool Description
spotify_status Check connection status and logged-in account
spotify_auth Authorize via browser (OAuth 2.0 PKCE)
spotify_logout Clear stored tokens

Search

Tool Parameters Description
search_tracks query, limit? Search for songs
search_artists query, limit? Search for artists
search_albums query, limit? Search for albums
search_playlists query, limit? Search for playlists

Playlists

Tool Parameters Description
get_playlists limit? Get your playlists
create_playlist name, description?, public? Create a new playlist
add_to_playlist playlistId, uris[], position? Add tracks
remove_from_playlist playlistId, uris[] Remove tracks

Playback

Tool Parameters Description
get_currently_playing — Current track, progress, device
play deviceId?, contextUri?, uris?[], offsetPosition?, positionMs? Start/resume playback
pause deviceId? Pause playback
next_track deviceId? Skip to next track
previous_track deviceId? Go to previous track
set_volume volumePercent, deviceId? Set volume (0–100)
get_devices — List Spotify Connect devices
transfer_playback deviceId, play? Switch playback device

Example Workflow

1. spotify_status            → check if authenticated
2. spotify_auth              → open browser to authorize (first time)
3. search_tracks query="Bohemian Rhapsody"
4. get_devices               → list available devices
5. play uris=["spotify:track:..."] deviceId="..."
6. get_currently_playing     → see what's playing
7. set_volume volumePercent=70
8. next_track                → skip to next
9. get_playlists             → see your playlists
10. create_playlist name="AI Picks"
11. add_to_playlist playlistId="..." uris=["spotify:track:..."]

Requirements

  • Node.js 18+
  • Spotify account (Free or Premium)
  • Spotify Premium required for: volume control, playback control

Technical Details

  • Protocol: Model Context Protocol (MCP) over stdio
  • Auth: OAuth 2.0 Authorization Code with PKCE
  • API: Spotify Web API v1
  • Token storage: ~/.striderlabs/spotify/tokens.json
  • Browser automation: Playwright (for OAuth browser launch)

License

MIT — Strider Labs

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.markswendsen-code/spotify

How do I install io.github.markswendsen-code/spotify?

Run claude mcp add io-github-markswendsen-code-spotify -- npx -y @striderlabs/mcp-spotify, then add the server to your MCP client's configuration.

Is io.github.markswendsen-code/spotify safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.markswendsen-code/spotify still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.