Spotify Streamable
Enables control of Spotify through natural language by searching the catalog, managing playback and devices, controlling playlists, and managing saved songs. Includes OAuth authentication and streamable HTTP transport for remote connectivity.
What is Spotify Streamable?
Spotify Streamable is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables control of spotify through natural language by searching the catalog, managing playback and devices, controlling playlists, and managing saved songs. includes oauth authentication and streamab...
Enables control of Spotify through natural language by searching the catalog, managing playback and devices, controlling playlists, and managing saved songs. Includes OAuth authentication and streamable HTTP transport for remote connectivity.
This server falls under the Communication and APIs categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables control of Spotify through natural language by searc
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx spotify-streamable-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Spotify Streamable
The Spotify Streamable MCP server bridges AI assistants and the Spotify Web API using a streamable HTTP transport, enabling real-time music control without a locally spawned process. It implements OAuth 2.0 for secure authentication and exposes five tools covering catalog search, playback control, playlist management, and library operations — all accessible via natural language through any MCP-compatible client.
Prerequisites
- Bun runtime (bun.sh) installed — the server is built with Bun, not Node.js
- A Spotify Premium account (playback control requires Premium)
- A Spotify Developer App with Client ID and Client Secret (create at developer.spotify.com/dashboard)
- The redirect URI http://127.0.0.1:3001/oauth/callback registered in your Spotify app settings
- An MCP-compatible client such as Claude Desktop
Clone the repository and install dependencies
Clone the repo and install dependencies using Bun. The server is not published to npm, so a local build is required.
git clone https://github.com/iceener/spotify-streamable-mcp-server.git
cd spotify-streamable-mcp-server
bun installCreate and configure the .env file
Copy the example env file and fill in your Spotify credentials. SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET come from your Spotify Developer Dashboard app.
cp .env.example .env
# Edit .env:
# PORT=3000
# AUTH_ENABLED=true
# SPOTIFY_CLIENT_ID=your_client_id
# SPOTIFY_CLIENT_SECRET=your_client_secret
# OAUTH_REDIRECT_URI=http://127.0.0.1:3001/oauth/callback
# OAUTH_SCOPES=user-read-playback-state user-modify-playback-state playlist-modify-public playlist-modify-private user-library-read user-library-modifyRegister the redirect URI in your Spotify app
In the Spotify Developer Dashboard, open your app, click 'Edit Settings', and add http://127.0.0.1:3001/oauth/callback to the Redirect URIs list. Save the settings.
Start the MCP server
Build and start the server. It will listen on the configured port and expose the MCP endpoint at /mcp.
bun run build
bun startConfigure your MCP client to connect via mcp-remote
Add the server to your MCP client config. Because this is a streamable HTTP server rather than a local process, clients connect using mcp-remote.
{
"mcpServers": {
"spotify": {
"command": "bunx",
"args": ["mcp-remote", "http://127.0.0.1:3000/mcp", "--transport", "http-only"],
"env": { "NO_PROXY": "127.0.0.1,localhost" }
}
}
}Authenticate with Spotify
On first use, the server will prompt you to complete the OAuth flow. Open the provided URL in a browser, log in to Spotify, and authorize the requested scopes. Tokens are encrypted and stored for subsequent sessions.
Spotify Streamable Examples
Client configuration
MCP client config for connecting to a locally running Spotify Streamable MCP server via mcp-remote HTTP transport.
{
"mcpServers": {
"spotify": {
"command": "bunx",
"args": [
"mcp-remote",
"http://127.0.0.1:3000/mcp",
"--transport",
"http-only"
],
"env": {
"NO_PROXY": "127.0.0.1,localhost"
}
}
}
}Prompts to try
Natural language prompts that use the five Spotify MCP tools: search_catalog, player_status, spotify_control, spotify_playlist, and spotify_library.
- "What song is playing right now and which device is it on?"
- "Search for albums by Radiohead and play OK Computer on my phone"
- "Pause the music, then skip to the next track"
- "Create a playlist called 'Focus Flow' and add the top 5 results for 'lo-fi beats' to it"
- "Save the currently playing track to my liked songs"Troubleshooting Spotify Streamable
Playback control commands fail with 'Premium required' error
Spotify's Web API requires a Spotify Premium subscription for all playback control endpoints. Free accounts can search the catalog and read library data, but cannot control playback.
OAuth callback fails or device_id errors occur
Confirm that http://127.0.0.1:3001/oauth/callback is added to your Spotify app's Redirect URIs (not localhost — Spotify treats 127.0.0.1 and localhost as different origins). For device_id issues, always extract the actual alphanumeric device ID from the player_status response rather than using the human-readable device name.
Server fails to start with 'command not found: bun'
Install Bun by running 'curl -fsSL https://bun.sh/install | bash' and restarting your terminal. Verify with 'bun --version'. The server is built with Bun and is not compatible with plain Node.js/npm.
Frequently Asked Questions about Spotify Streamable
What is Spotify Streamable?
Spotify Streamable is a Model Context Protocol (MCP) server that enables control of spotify through natural language by searching the catalog, managing playback and devices, controlling playlists, and managing saved songs. includes oauth authentication and streamable http transport for remote connectivity. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Spotify Streamable?
Follow the installation instructions on the Spotify Streamable GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Spotify Streamable?
Spotify Streamable works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Spotify Streamable free to use?
Yes, Spotify Streamable is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.
Spotify Streamable Alternatives — Similar Communication Servers
Looking for alternatives to Spotify Streamable? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Spotify Streamable in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Spotify Streamable?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.