MMCPMarkets
LS

llyfn/spotify-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

5 stars 4 forks Качество 80 Тренд 27MIT
Repository Install

MCP server for the Spotify Web API — gives Claude and other AI assistants tools to search music, control playback, manage playlists, library, and podcasts.

Обзор

A Model Context Protocol (MCP) server that provides tools for interacting with the Spotify Web API. Enables AI assistants like Claude to search music, control playback, manage playlists, and more. - - Find tracks, albums, artists, playlists, shows, episodes, and audiobooks - - Play, pause, skip, seek, volume, shuffle, repeat, queue management - - Create, update, add/remove/reorder tracks (auto-chunks large batches) - - View and manage saved tracks, albums, shows, episodes, and audiobooks - - Get details on tracks, albums, artists, episodes, and chapters - - Browse shows, episodes, audiobooks, and chapters - - List followed artists; follow/unfollow artists, users, and playlists through the library tools by URI - - View profile, top artists/tracks, diagnostic whoami - - Subscribable snapshots of profile, playback, queue, top items - - Pre-baked workflows for playlist building, listening summaries, library cleanup - - stdio (default), sse, and streamable-http - Uses only non-deprecated...

README

Показан фрагмент оригинального README. Открыть оригинал.

Spotify MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Spotify Web API. Enables AI assistants like Claude to search music, control playback, manage playlists, and more.

Features

  • Search - Find tracks, albums, artists, playlists, shows, episodes, and audiobooks
  • Playback Control - Play, pause, skip, seek, volume, shuffle, repeat, queue management
  • Playlists - Create, update, add/remove/reorder tracks (auto-chunks large batches)
  • Library - View and manage saved tracks, albums, shows, episodes, and audiobooks
  • Browse - Get details on tracks, albums, artists, episodes, and chapters
  • Podcasts & Audiobooks - Browse shows, episodes, audiobooks, and chapters
  • Follow - List followed artists; follow/unfollow artists, users, and playlists through the library tools by URI
  • User Profile - View profile, top artists/tracks, diagnostic whoami
  • Resources - Subscribable snapshots of profile, playback, queue, top items
  • Prompts - Pre-baked workflows for playlist building, listening summaries, library cleanup
  • Transports - stdio (default), sse, and streamable-http
  • Uses only non-deprecated Spotify Web API endpoints

Example interactions

  • “What am I listening to right now?”
  • “Play some Radiohead on my living room speaker.”
  • “Skip this track and turn the volume down to 30.”
  • “Build me a playlist of 25 chill tracks based on what I’ve been listening to this week.”
  • “Add the last three songs I played to my ‘Focus’ playlist.”
  • “Show me my top artists from the last six months.”
  • “Search for live albums by Nils Frahm and save the best one to my library.”
  • “Unfollow every playlist I haven’t opened that wasn’t made by me.”
  • “Queue up the next episode of the show I was listening to yesterday.”

Prerequisites

  • uv — install with curl -LsSf https://astral.sh/uv/install.sh | sh
  • A Spotify Developer account
  • A Spotify app with Client ID and Client Secret

Getting Your Spotify Credentials

  1. Go to the Spotify Developer Dashboard
  2. Click Create App
  3. Fill in the app details:
    • App name: Choose any name (e.g., “My MCP Server”)
    • App description: Optional
    • Redirect URI: http://127.0.0.1:8888/callback
    • Which API/SDKs are you planning to use?: Select Web API
  4. Click Save
  5. On your app’s page, find your Client ID
  6. Click Show client secret to reveal your Client Secret

Important: The redirect URI must exactly match http://127.0.0.1:8888/callback (or whatever you set in SPOTIFY_REDIRECT_URI). Do not use localhost — use 127.0.0.1.

Installation

Открыть полный README на GitHub

Установка

uvx mcp-server-spotify
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "spotify": { "command": "uvx", "args": ["mcp-server-spotify"], "env": { "SPOTIFY_CLIENT_ID": "your_client_id", "SPOTIFY_CLIENT_SECRET": "your_client_secret" } } } }