Skip to content
Back to search

spotify-mcp

MCP to connect your LLM with Spotify.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/varunneal--spotify-mcp/badge.svg)](/listings/varunneal--spotify-mcp)

HTML

<a href="/listings/varunneal--spotify-mcp"><img src="/api/listings/varunneal--spotify-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 175 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # spotify-mcp MCP server
  2. MCP project to connect Claude with Spotify. Built on top of [spotipy-dev's API](https://github.com/spotipy-dev/spotipy/tree/2.24.0).
  3. **[Notice March 2026]: Inactive project. Most PRs will not be merged.**
  4. ## Features
  5. - Start, pause, and skip playback
  6. - Search for tracks/albums/artists/playlists
  7. - Get info about a track/album/artist/playlist
  8. - Manage the Spotify queue
  9. - Manage, create, and update playlists
  10. ## Demo
  11. <details>
  12. <summary>
  13. Video -- turn on audio
  14. </summary>
  15. https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894
  16. </details>
  17. ## Configuration
  18. ### Getting Spotify API Keys
  19. Create an account on [developer.spotify.com](https://developer.spotify.com/). Navigate to [the dashboard](https://developer.spotify.com/dashboard).
  20. Create an app with redirect_uri as http://127.0.0.1:8080/callback.
  21. You can choose any port you want but you must use http and an explicit loopback address (IPv4 or IPv6).
  22. See [here](https://developer.spotify.com/documentation/web-api/concepts/redirect_uri) for more info/troubleshooting.
  23. You may have to restart your MCP environment (e.g. Claude Desktop) once or twice before it works.
  24. ### Locating MCP Config
  25. For Cursor, Claude Desktop, or any other MCP-enabled client you will have to locate your config.
  26. - Claude Desktop location on MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
  27. - Claude Desktop location on Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  28. ### Run this project with uvx
  29. Add this snippet to your MCP Config.
  30. ```json
  31. {
  32. "mcpServers": {
  33. "spotify": {
  34. "command": "uvx",
  35. "args": [
  36. "--python", "3.12",
  37. "--from", "git+https://github.com/varunneal/spotify-mcp",
  38. "spotify-mcp"
  39. ],
  40. "env": {
  41. "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
  42. "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
  43. "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
  44. }
  45. }
  46. }
  47. }
  48. ```
  49. ### Run this project locally
  50. Using UVX will open the spotify redirect URI for every tool call. To avoid this, you can run this project locally by cloning this repo:
  51. ```bash
  52. git clone https://github.com/varunneal/spotify-mcp.git
  53. ```
  54. Add it to your MCP Config like this:
  55. ```json
  56. "spotify": {
  57. "command": "uv",
  58. "args": [
  59. "--directory",
  60. "/path/to/spotify-mcp",
  61. "run",
  62. "spotify-mcp"
  63. ],
  64. "env": {
  65. "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
  66. "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
  67. "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
  68. }
  69. }
  70. ```
  71. ### Troubleshooting
  72. Please open an issue if you can't get this MCP working. Here are some tips:
  73. 1. Make sure `uv` is updated. I recommend version `>=0.54`.
  74. 2. If cloning locally, enable execution permisisons for the project: `chmod -R 755`.
  75. 3. Ensure you have Spotify premium (needed for running developer API).
  76. This MCP will emit logs to std err (as specified in the MCP) spec. On Mac the Claude Desktop app should emit these logs
  77. to `~/Library/Logs/Claude`.
  78. On other platforms [you can find logs here](https://modelcontextprotocol.io/quickstart/user#getting-logs-from-claude-for-desktop).
  79. You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
  80. ```bash
  81. npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp
  82. ```
  83. Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
  84. ## TODO
  85. Unfortunately, a bunch of cool features have [now been deprecated](https://techcrunch.com/2024/11/27/spotify-cuts-developer-access-to-several-of-its-recommendation-features/)
  86. from the Spotify API. Most new features will be relatively minor or for the health of the project:
  87. - tests.
  88. - ~~adding API support for managing playlists.~~
  89. - adding API support for paginated search results/playlists/albums.
  90. PRs appreciated! Thanks to @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj, @JJGO and others for contributions.
  91. [//]: # (## Deployment)
  92. [//]: # (&#40;todo&#41;)
  93. [//]: # (### Building and Publishing)
  94. [//]: # ()
  95. [//]: # (To prepare the package for distribution:)
  96. [//]: # ()
  97. [//]: # (1. Sync dependencies and update lockfile:)
  98. [//]: # ()
  99. [//]: # (```bash)
  100. [//]: # (uv sync)
  101. [//]: # (```)
  102. [//]: # ()
  103. [//]: # (2. Build package distributions:)
  104. [//]: # ()
  105. [//]: # (```bash)
  106. [//]: # (uv build)
  107. [//]: # (```)
  108. [//]: # ()
  109. [//]: # (This will create source and wheel distributions in the `dist/` directory.)
  110. [//]: # ()
  111. [//]: # (3. Publish to PyPI:)
  112. [//]: # ()
  113. [//]: # (```bash)
  114. [//]: # (uv publish)
  115. [//]: # (```)
  116. [//]: # ()
  117. [//]: # (Note: You'll need to set PyPI credentials via environment variables or command flags:)
  118. [//]: # ()
  119. [//]: # (- Token: `--token` or `UV_PUBLISH_TOKEN`)
  120. [//]: # (- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.