Vulpes Spotify Mcp is an MCP server that integrates Spotify's Web API with Model Context Protocol clients like Claude Desktop. It connects an AI assistant directly to your active Spotify account and connected playback devices. Developers, music listeners, and productivity enthusiasts use this server to control music playback through conversational AI rather than manually navigating the Spotify application. By exposing tools to search tracks, inspect playlists, retrieve currently playing song metadata, and discover available playback hardware, it enables language models to manage ambient audio environments dynamically. Users can instruct the assistant to find specific songs, start playlists with optional shuffle settings, or automatically queue and play top search results. Active playback controls require a Spotify Premium account, alongside developer credentials and an active Spotify session running on a connected device, providing programmatic access to personal listening libraries.
Category: Communication & Messaging
Tags: audio, music, spotify, streaming
bash git clone https://github.com/ejfox/vulpes-spotify-mcp.git cd vulpes-spotify-mcp npm install 2. Obtain your Client ID and Client Secret from the Spotify Developer Dashboard, then create a .env file. 3. Generate your refresh token by running npm run get-token (or node src/simple-auth.js) and add SPOTIFY_REFRESH_TOKEN to .env. 4. Build the project: bash npm run build 5. Add the server to your claude_desktop_config.json: json { "mcpServers": { "spotify": { "command": "node", "args": ["/absolute/path/to/vulpes-spotify-mcp/dist/index.js"], "env": { "SPOTIFY_CLIENT_ID": "your_client_id", "SPOTIFY_CLIENT_SECRET": "your_client_secret", "SPOTIFY_REDIRECT_URI": "http://localhost:8888", "SPOTIFY_REFRESH_TOKEN": "your_refresh_token" } } } } 6. Alternatively, install via Smithery using npx -y @smithery/cli install @ejfox/vulpes-spotify-mcp --client claude.Part of MCP Servers
Vulpes Spotify Mcp is a Model Context Protocol server that enables AI clients like Claude Desktop to interact with Spotify. It provides tools to search tracks, play audio, list playlists, view queue information, and inspect active Spotify playback devices.
You need Node.js version 16 or higher, a Spotify Developer Account to obtain credentials, an MCP-compatible client like Claude Desktop, and a Spotify Premium account if you plan to use audio playback controls.
Spotify's API requires an open, active player session to receive playback commands. To fix this, ensure the Spotify desktop or mobile app is open and playing or paused on at least one device before issuing playback tools.
Yes, Vulpes Spotify Mcp is open-source software licensed under the MIT License, with source code available on GitHub.