A
licenseNot graded
qualityD
maintenanceIntegrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
118 npm
MIT
Spotify MCP
by arikhi14
Provides tools for securely interacting with and analyzing a user's Spotify data, including planned OAuth 2.0 authorization, read-only access to profile, playlists, saved tracks, top tracks/artists, recently played, playlist creation/mutation, and higher-level listening analytics.
Click on "Deploy 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., "@Spotify MCP show me my top 10 tracks from the past month"
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.
Spotify MCP
A Model Context Protocol (MCP) server for securely interacting with and analyzing a user's Spotify data.
Status: Phase 1 scaffold. Spotify OAuth and Web API integrations come next.
Why this project
The goal is to build more than a thin API wrapper. The finished server will combine MCP tooling, Spotify OAuth 2.0, typed API clients, pagination, rate-limit handling, caching, analytics, tests, and CI.
Related MCP server: Spotify MCP Server
Current functionality
MCP Python SDK v2 server
server_statusdiagnostic toolinstallable Python package
automated test
GitHub Actions CI
secrets-safe repository structure
Requirements
Python 3.10+
uvrecommended
Setup
git clone <your-repo-url>
cd spotify-mcp
uv sync --extra devRun the tests:
uv run pytestOpen the server in the MCP Inspector:
uv run mcp dev src/spotify_mcp/server.pyOr run the stdio server directly:
uv run spotify-mcpRoadmap
Spotify OAuth 2.0 authorization and refresh-token storage
Read-only tools: profile, playlists, saved tracks, top tracks/artists, recently played
Playlist creation and mutation tools
Pagination, retry/backoff, caching, and structured errors
Higher-level listening analytics
Broader tests, documentation, packaging, and MCP Registry publishing
Security
Never commit Spotify credentials or OAuth tokens. Copy .env.example to .env locally when Spotify authorization is added.
License
MIT
Available Tools
1 toolserver_statusA
Return basic server health and Spotify connection state.
Inputs: no named parameters. Returns: Structured result returned by the status tool.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A3.5/5.0
Scored across 1 tool
Disambiguation5/5
There is only one tool, so there is no ambiguity or overlap with other tools. An agent can tell exactly what server_status does.
Naming Consistency5/5
With a single tool, there are no conflicting naming conventions to compare. server_status uses clear, consistent snake_case formatting.
Tool Count1/5
A Spotify MCP server with only one health-check tool is an extreme mismatch for the likely domain scope. This is far too few tools to support meaningful Spotify interactions.
Completeness1/5
The surface contains only a server health/status check and no Spotify operations such as search, playlists, playback, or library access. It is severely incomplete for a Spotify MCP server.
Maintenance
ActivityStale
ResponsivenessNo recent community issues
Related MCP Connectors
Spotify MCP server for ChatGPT, Claude and any AI agent: search songs and artists, list playlists, read playlist songs, create playlist, add songs to playlist, remove songs from playlist, set playlist public or private and save to Liked Songs in your own Spotify account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Spotify yourself; Cotlet does not store your password and you need no Spotify API key. About the official Spotify API: Spotify has a full Web API and, since 23 Apr 2026, an official connector for Claude (checked 5 Nov 2026). The API needs an app you register, and in development mode the app owner must have Premium and the app allows 5 users; unlimited users need a registered business with at least 250,000 monthly users. Setup and FAQ: https://cotlet.dev/integrations/spotify-api-mcp-server
Builds narrated, playable music stories, explores sample lineage, and saves verified playlists.
Spotify MCP — Web API via client_credentials OAuth
Spotify: Spotify Data API for Millions of songs & podcasts, artists, albums, playlists and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude Desktop to interact with Spotify's music streaming service, supporting playback control, playlist management, music search, and user profile access.412MIT
- FlicenseNot gradedqualityDmaintenanceEnables remote interaction with Spotify through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists with per-user OAuth authentication. It is hosted on Cloudflare Workers and supports remote MCP over HTTP for compatible clients.2-
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables searching and managing Spotify music, playlists, artists, albums, and audiobooks through natural language.2457 npmMIT