Allows control of Spotify playback, management of playlists and library, searching music, and retrieving user profile and listening history via the Spotify Web API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@spotifyMCP play my discover weekly playlist"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Spotify. Control playback, manage playlists, search music, and more — from any MCP-compatible AI client.
34 tools. 2 dependencies. Works locally or on a server.
git clone https://github.com/real-kijmoshi/SpotifyMCP.git
cd spotifyMCP
npm install # or bun install
npm run setup # or bun run setupThe setup script will:
Show you where to get a Spotify Developer app
Ask for your Client ID, Secret (optional), port, and webhook URL
Generate an API key to protect your server from unauthorized access
Open Spotify authorization in your browser
Handle the OAuth callback automatically
Optionally start the server with a public tunnel (cloudflared) and run it as a background service (pm2)
Related MCP server: Spotify MCP Server
Add one of these to claude_desktop_config.json:
Local (stdio):
{
"mcpServers": {
"spotify": {
"command": "node",
"args": ["/absolute/path/to/spotifyMCP/src/index.js", "--stdio"]
}
}
}HTTP (local or remote):
{
"mcpServers": {
"spotify": {
"url": "http://localhost:3000/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Via tunnel (public URL):
{
"mcpServers": {
"spotify": {
"url": "https://your-tunnel.trycloudflare.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}# Local stdio mode (for Claude Desktop)
node src/index.js --stdio
# HTTP server on port 3000
node src/index.js --port 3000
# HTTP server with public tunnel
node src/index.js --port 3000 --tunnel
# As a pm2 background service with tunnel
npm run service:installnpm run service:logs # view logs (shows tunnel URL)
npm run service:status # check status
npm run service:restart # restart
npm run service:stop # stop
npm run service:remove # remove serviceLog in with your Spotify account
Click Create App
Set a name (e.g. "spotifyMCP") and description
Add Redirect URI: http://127.0.0.1:3080/callback (local) or the HTTPS URL shown during setup (server)
Click Save
Copy your Client ID from the app settings page
When running on a remote server, the setup automatically starts a cloudflared tunnel for the OAuth callback. This gives you a real HTTPS URL (e.g. https://xxxx.trycloudflare.com/callback) that Spotify accepts.
cloudflared must be installed (https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)
The tunnel starts on port 3080, gets a temporary HTTPS URL, then closes after auth completes
No self-signed certs, no SSH tunnels needed
Tool | Description |
| Get current playback state |
| Get currently playing track |
| Start or resume playback |
| Pause playback |
| Skip to next track |
| Skip to previous track |
| Seek to position (ms) |
| Set volume (0-100) |
| Toggle shuffle mode |
| Set repeat mode |
| Transfer to another device |
Tool | Description |
| Search tracks, artists, albums, playlists |
| Search tracks only |
| Search artists only |
| Search albums only |
| Search playlists only |
Tool | Description |
| List your playlists |
| Get playlist and its tracks |
| Create a new playlist |
| Add tracks to playlist |
| Remove tracks from playlist |
| Follow/save a playlist |
Tool | Description |
| Get your Spotify profile |
| Get your top tracks |
| Get your top artists |
| List available devices |
| Get recently played tracks |
Tool | Description |
| List saved/liked tracks |
| List saved albums |
| Check if tracks are in library |
| Save tracks to library |
| Remove tracks from library |
Tool | Description |
| Get current playback queue |
| Add track to queue |
spotifyMCP/
├── setup.js # Interactive quickstart CLI
└── src/
├── index.js # Entry point (--stdio or --port N --tunnel)
├── create-server.js # McpServer factory + tool registration
├── http-handler.js # node:http + StreamableHTTPServerTransport
├── tunnel.js # Auto-detect cloudflared / localtunnel
├── auth/
│ ├── oauth.js # PKCE generation, token exchange/refresh
│ ├── auth-server.js # Ephemeral OAuth callback server
│ └── token-store.js # .spotify-auth.json persistence
├── spotify/
│ └── api.js # Spotify Web API fetch wrapper
└── tools/ # 7 tool modules, 34 tools total.env)SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=optional
REDIRECT_URI=http://127.0.0.1:3080/callback
MCP_PORT=3000
MCP_API_KEY=auto_generated_key
LOCATION=local
# SERVER_IP=10.0.0.5
# WEBHOOK_URL=When running in HTTP mode (especially with a public tunnel), the server is protected by an API key. The setup script generates one automatically.
For Claude Desktop, add the headers field:
{
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}The API key is required for all HTTP requests. Stdio mode (local) does not use API key auth since it's already protected by process isolation.
MIT
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
Hosted MCP with 91 agent tools: X, domains, SEO, Maps, Trends, Search, YouTube, TikTok, and more.
MCP server for Suno AI music generation, lyrics, and covers
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/real-kijmoshi/SpotifyMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server