Skip to main content
Glama
Spotify MCP Server

Spotify MCP Server

by llyfn

Spotify MCPサーバー

PyPI

Model Context Protocol (MCP)サーバーで、Spotify Web APIと連携するためのツールを提供します。ClaudeのようなAIアシスタントが音楽の検索、再生制御、プレイリスト管理などを行えるようになります。

機能

  • 検索 - トラック、アルバム、アーティスト、プレイリスト、番組、エピソード、オーディオブックの検索

  • 再生制御 - 再生、一時停止、スキップ、シーク、音量調整、シャッフル、リピート、キュー管理

  • プレイリスト - 作成、更新、トラックの追加/削除/並べ替え

  • ライブラリ - 保存済みトラック、アルバム、番組、エピソード、オーディオブックの表示と管理

  • ブラウズ - アルバム詳細、アーティスト情報、トラックメタデータの取得

  • ポッドキャスト & オーディオブック - 番組、エピソード、オーディオブック、チャプターのブラウズ

  • ユーザープロフィール - プロフィール、トップアーティスト/トラック、フォロー中のアーティストの表示

  • 44種類のツール - 非推奨ではないSpotify Web APIエンドポイントを網羅

Related MCP server: Spotify MCP Server

前提条件

  • uv — curl -LsSf https://astral.sh/uv/install.sh | sh でインストール

  • Spotify Developer アカウント

  • Client IDとClient Secretを持つSpotifyアプリ

Spotify認証情報の取得

  1. Spotify Developer Dashboard にアクセス

  2. Create App をクリック

  3. アプリの詳細を入力:

    • App name: 任意の名前 (例: "My MCP Server")

    • App description: 任意

    • Redirect URI: http://127.0.0.1:8888/callback

    • Which API/SDKs are you planning to use?: Web API を選択

  4. Save をクリック

  5. アプリのページで Client ID を確認

  6. Show client secret をクリックして Client Secret を表示

重要: リダイレクトURIは http://127.0.0.1:8888/callback (または SPOTIFY_REDIRECT_URI に設定したもの) と完全に一致している必要があります。localhost は使用せず、127.0.0.1 を使用してください。

インストール

以下のクライアントから選択してください。すべての例で uvx を使用してサーバーをオンデマンドで取得するため、クローンや手動インストールは不要です。

Claude Code

claude mcp add spotify \
  -e SPOTIFY_CLIENT_ID=your_client_id \
  -e SPOTIFY_CLIENT_SECRET=your_client_secret \
  -- uvx mcp-server-spotify

その他のMCPクライアント

ほとんどのMCPクライアントはJSONファイルでサーバーを設定します。クライアントのMCP設定に以下のエントリを追加してください:

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

ローカルチェックアウトからの実行

開発用、または修正版を実行したい場合:

git clone https://github.com/llyfn/spotify-mcp.git
cd spotify-mcp && uv sync

その後、uvx の代わりにローカルのチェックアウト先をクライアントに指定します:

"command": "uv",
"args": ["--directory", "/absolute/path/to/spotify-mcp", "run", "mcp-server-spotify"]

設定

変数

必須

デフォルト

説明

SPOTIFY_CLIENT_ID

はい

—

SpotifyアプリのClient ID

SPOTIFY_CLIENT_SECRET

はい

—

SpotifyアプリのClient Secret

SPOTIFY_REDIRECT_URI

いいえ

http://127.0.0.1:8888/callback

OAuthリダイレクトURI

認証

このサーバーはSpotifyの Authorization Code フローを使用します:

  1. 初回使用時、サーバーがブラウザでSpotifyのログインページを開きます

  2. Spotifyがアクセス許可を求めます — サーバーはツールセット全体(再生、ライブラリ、プレイリスト、ユーザーデータ)に必要なすべてのスコープを要求します

  3. 承認後、Spotifyはローカルのコールバックサーバーにリダイレクトします

  4. サーバーは認証コードをアクセストークン/リフレッシュトークンと交換します

  5. トークンは ~/.spotify-mcp/credentials.json に安全に保存されます

  6. トークンは期限切れになると自動的に更新されます

ヘッドレス環境(SSH、Docker)で実行する場合、認証URLがstderrに出力されます。それをコピーして手動でブラウザに貼り付けてください。

再認証

再認証が必要な場合(アクセスを取り消した後など)、保存された認証情報を削除してください:

rm ~/.spotify-mcp/credentials.json

利用可能なツール

検索

ツール

説明

search

トラック、アルバム、アーティスト、プレイリスト、番組、エピソード、オーディオブックの検索

アルバム

ツール

説明

get_album

IDによるアルバム詳細の取得

get_album_tracks

アルバム内のトラック取得

アーティスト

ツール

説明

get_artist

IDによるアーティスト詳細の取得

get_artist_albums

アーティストのアルバム取得

トラック

ツール

説明

get_track

IDによるトラック詳細の取得

プレイリスト

ツール

説明

get_playlist

プレイリスト詳細の取得

update_playlist

プレイリスト名、説明、公開設定の更新

get_playlist_items

プレイリスト内のアイテム取得

add_playlist_items

プレイリストへのトラック/エピソードの追加

remove_playlist_items

プレイリストからのアイテム削除

reorder_playlist_items

プレイリスト内のアイテム並べ替え

get_my_playlists

現在のユーザーのプレイリスト取得

create_playlist

新しいプレイリストの作成

ライブラリ

ツール

説明

get_saved_tracks

保存済みトラックの取得

get_saved_albums

保存済みアルバムの取得

get_saved_shows

保存済み番組の取得

get_saved_episodes

保存済みエピソードの取得

get_saved_audiobooks

保存済みオーディオブックの取得

save_to_library

ライブラリへのアイテム保存

remove_from_library

ライブラリからのアイテム削除

check_saved_in_library

アイテムがライブラリにあるか確認

プレイヤー

ツール

説明

get_playback_state

現在の再生状態の取得

get_currently_playing

現在再生中のトラック取得

play

再生の開始または再開

pause

再生の一時停止

next_track

次のトラックへスキップ

previous_track

前のトラックへスキップ

seek

トラック内の位置へシーク

set_repeat

リピートモードの設定 (track/context/off)

set_volume

再生音量の設定

toggle_shuffle

シャッフルモードの切り替え

transfer_playback

他のデバイスへの再生転送

get_devices

利用可能なデバイスの取得

add_to_queue

再生キューへのアイテム追加

get_queue

再生キューの取得

get_recently_played

最近再生したトラックの取得

番組 & ポッドキャスト

ツール

説明

get_show

番組詳細の取得

get_show_episodes

番組のエピソード取得

オーディオブック

ツール

説明

get_audiobook

オーディオブック詳細の取得

get_audiobook_chapters

オーディオブックのチャプター取得

get_chapter

チャプター詳細の取得

ユーザー

ツール

説明

get_my_profile

現在のユーザーのプロフィール取得

get_my_top_items

トップアーティストまたはトラックの取得

アーティスト/ユーザーのフォローには、同じ save_to_library / remove_from_library / check_saved_in_library ツールを使用します — アーティストまたはユーザーのURIを渡してください。

コントリビューション

開発環境のセットアップとガイドラインについては CONTRIBUTING.md を参照してください。

ライセンス

MIT - 詳細は LICENSE を参照してください。

Available Tools

47 tools
add_playlist_itemsA

Add tracks or episodes to a playlist. Auto-chunks at 100 items per request.

    Args:
        playlist_id: The Spotify ID of the playlist.
        uris: List of Spotify URIs to add (e.g. ["spotify:track:xxx"]).
        position: Position to insert items (0-based). Appends to end if not specified.
            When chunking, subsequent chunks insert immediately after the previous.
    

Inputs: uris (required), playlist_id (required), position. Returns: result

add_to_queueA

Add a track or episode to the playback queue.

    Args:
        uri: Spotify URI of the item to add. E.g. "spotify:track:xxx".
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: uri (required), device_id. Returns: result

check_saved_in_libraryB

Check whether items are saved or artists/users/playlists are followed.

    Auto-chunks at 40 URIs per request.

    Args:
        uris: Spotify URIs: track, album, episode, show, audiobook, artist, user, or
            playlist (e.g. ["spotify:track:xxx", "spotify:artist:yyy"]).
    

Inputs: uris (required). Returns: result

create_playlistB

Create a new playlist for the current user.

    Args:
        name: Name for the new playlist.
        description: Description for the playlist.
        public: Whether the playlist should be public (default True).
    

Inputs: name (required), public, description. Returns: result

get_albumA

Get details of a Spotify album by its ID.

    Args:
        album_id: The Spotify ID of the album.
        market: ISO 3166-1 alpha-2 country code; affects availability/relinking.
    

Inputs: album_id (required), market. Returns: result

get_album_tracksA

Get tracks of a Spotify album.

    Args:
        album_id: The Spotify ID of the album.
        limit: Maximum number of tracks to return (1-50, default 20).
        offset: Index of the first track to return (default 0).
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: album_id (required), limit, market, offset. Returns: result

get_artistA

Get details of a Spotify artist by their ID.

    Args:
        artist_id: The Spotify ID of the artist.
    

Inputs: artist_id (required). Returns: result

get_artist_albumsB

Get albums by a Spotify artist.

    Args:
        artist_id: The Spotify ID of the artist.
        include_groups: Comma-separated album types: album, single, appears_on, compilation.
        limit: Maximum number of albums to return (1-10, default 10).
        offset: Index of the first album to return (default 0).
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: artist_id (required), limit, market, offset, +1 more. Returns: result

get_audiobookB

Get details of a Spotify audiobook.

    Args:
        audiobook_id: The Spotify ID of the audiobook.
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: audiobook_id (required), market. Returns: result

get_audiobook_chaptersA

Get chapters of a Spotify audiobook.

    Args:
        audiobook_id: The Spotify ID of the audiobook.
        limit: Maximum number of chapters to return (1-50, default 20).
        offset: Index of the first chapter to return (default 0).
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: audiobook_id (required), limit, market, offset. Returns: result

get_chapterA

Get details of a specific audiobook chapter.

    Args:
        chapter_id: The Spotify ID of the chapter.
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: chapter_id (required), market. Returns: result

get_currently_playingB

Get the currently playing track or episode.

Inputs: no named parameters. Returns: result

get_devicesA

Get the user's available Spotify devices.

Inputs: no named parameters. Returns: result

get_episodeA

Get details of a podcast episode.

    Args:
        episode_id: The Spotify ID of the episode.
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: episode_id (required), market. Returns: result

get_followed_artistsA

Get the current user's followed artists. Cursor-paginated.

    To follow or unfollow, use `save_to_library` / `remove_from_library` with Spotify URIs.

    Args:
        limit: Maximum number of artists to return (1-50, default 20).
        after: Cursor (last artist ID from previous page) to fetch the next page.
    

Inputs: after, limit. Returns: result

get_my_playlistsA

Get the current user's playlists.

    Args:
        limit: Maximum number of playlists to return (1-50, default 20).
        offset: Index of the first playlist to return (default 0).
    

Inputs: limit, offset. Returns: result

get_my_profileA

Get the current user's Spotify profile.

Inputs: no named parameters. Returns: result

get_my_top_itemsB

Get the current user's top artists or tracks.

    Args:
        item_type: Type of items: "artists" or "tracks" (default "tracks").
        time_range: "short_term" (~4wk), "medium_term" (~6mo), or "long_term" (all time).
        limit: Maximum number of items to return (1-50, default 20).
        offset: Index of the first item to return (default 0).
    

Inputs: limit, offset, item_type, time_range. Returns: result

get_playback_stateA

Get the current playback state including track, device, and progress.

Inputs: no named parameters. Returns: result

get_playlistA

Get details of a Spotify playlist.

    Shows playlist metadata plus the first 20 tracks. For more tracks or
    pagination, use `get_playlist_items`.

    Args:
        playlist_id: The Spotify ID of the playlist.
        market: ISO 3166-1 alpha-2 country code; affects track availability.
    

Inputs: playlist_id (required), market. Returns: result

get_playlist_itemsB

Get items (tracks/episodes) in a playlist.

    Args:
        playlist_id: The Spotify ID of the playlist.
        limit: Maximum number of items to return (1-50, default 20).
        offset: Index of the first item to return (default 0).
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: playlist_id (required), limit, market, offset. Returns: result

get_queueB

Get the current playback queue.

Inputs: no named parameters. Returns: result

get_recently_playedB

Get the user's recently played tracks.

    Args:
        limit: Maximum number of items to return (1-50, default 20).
        after: Unix-ms cursor; return items played AFTER this timestamp.
        before: Unix-ms cursor; return items played BEFORE this timestamp.
            Only one of `after` / `before` may be set.
    

Inputs: after, limit, before. Returns: result

get_saved_albumsA

Get the current user's saved albums.

    Args:
        limit: Maximum number of albums to return (1-50, default 20).
        offset: Index of the first album to return (default 0).
    

Inputs: limit, offset. Returns: result

get_saved_audiobooksA

Get the current user's saved audiobooks.

    Args:
        limit: Maximum number of audiobooks to return (1-50, default 20).
        offset: Index of the first audiobook to return (default 0).
    

Inputs: limit, offset. Returns: result

get_saved_episodesA

Get the current user's saved episodes.

    Args:
        limit: Maximum number of episodes to return (1-50, default 20).
        offset: Index of the first episode to return (default 0).
    

Inputs: limit, offset. Returns: result

get_saved_showsA

Get the current user's saved shows (podcasts).

    Args:
        limit: Maximum number of shows to return (1-50, default 20).
        offset: Index of the first show to return (default 0).
    

Inputs: limit, offset. Returns: result

get_saved_tracksA

Get the current user's saved tracks.

    Args:
        limit: Maximum number of tracks to return (1-50, default 20).
        offset: Index of the first track to return (default 0).
    

Inputs: limit, offset. Returns: result

get_showA

Get details of a Spotify show (podcast).

    Args:
        show_id: The Spotify ID of the show.
        market: ISO 3166-1 alpha-2 country code; affects availability.
    

Inputs: show_id (required), market. Returns: result

get_show_episodesA

Get episodes of a Spotify show.

    Args:
        show_id: The Spotify ID of the show.
        limit: Maximum number of episodes to return (1-50, default 20).
        offset: Index of the first episode to return (default 0).
        market: ISO 3166-1 alpha-2 country code.
    

Inputs: show_id (required), limit, market, offset. Returns: result

get_trackA

Get details of a Spotify track by its ID.

    Args:
        track_id: The Spotify ID of the track.
        market: ISO 3166-1 alpha-2 country code; affects availability/relinking.
    

Inputs: track_id (required), market. Returns: result

next_trackA

Skip to the next track.

    Args:
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: device_id. Returns: result

pauseB

Pause playback on the active device.

    Args:
        device_id: ID of the device to pause. If not provided, pauses the active device.
    

Inputs: device_id. Returns: result

playA

Start or resume playback.

    Args:
        device_id: ID of the device to play on. Uses active device if omitted.
        context_uri: Spotify URI of context (album, artist, playlist).
        uris: List of Spotify track URIs to play. E.g. ["spotify:track:xxx"].
        offset_position: Position in the context to start playback (0-based index).
        position_ms: Position in milliseconds to seek to.
    

Inputs: uris, device_id, context_uri, position_ms, +1 more. Returns: result

previous_trackA

Skip to the previous track.

    Args:
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: device_id. Returns: result

remove_from_libraryA

Remove items from the user's library, or unfollow artists, users, and playlists.

    Auto-chunks at 40 URIs per request.

    Args:
        uris: Spotify URIs: track, album, episode, show, audiobook, artist, user, or
            playlist (e.g. ["spotify:track:xxx", "spotify:playlist:yyy"]).
    

Inputs: uris (required). Returns: result

remove_playlist_itemsA

Remove tracks or episodes from a playlist. Auto-chunks at 100 items per request.

    Args:
        playlist_id: The Spotify ID of the playlist.
        uris: List of Spotify URIs to remove (e.g. ["spotify:track:xxx"]).
    

Inputs: uris (required), playlist_id (required). Returns: result

reorder_playlist_itemsB

Reorder items in a playlist.

    Args:
        playlist_id: The Spotify ID of the playlist.
        range_start: Position of the first item to be reordered.
        insert_before: Position where the items should be inserted.
        range_length: Number of items to reorder (default 1).
    

Inputs: playlist_id (required), range_start (required), insert_before (required), range_length. Returns: result

save_to_libraryA

Save items to the user's library, or follow artists, users, and playlists.

    Auto-chunks at 40 URIs per request.

    Args:
        uris: Spotify URIs: track, album, episode, show, audiobook, artist, user, or
            playlist (e.g. ["spotify:track:xxx", "spotify:artist:yyy"]).
    

Inputs: uris (required). Returns: result

seekA

Seek to a position in the currently playing track.

    Args:
        position_ms: Position in milliseconds to seek to.
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: position_ms (required), device_id. Returns: result

set_repeatA

Set the repeat mode for playback.

    Args:
        state: Repeat mode: "track", "context", or "off".
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: state (required), device_id. Returns: result

set_volumeA

Set the playback volume.

    Args:
        volume_percent: Volume level (0-100).
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: volume_percent (required), device_id. Returns: result

toggle_shuffleA

Set or toggle shuffle mode for playback.

    Args:
        state: True to enable, False to disable. If omitted, flips the current state.
        device_id: ID of the device. If not provided, uses the active device.
    

Inputs: state, device_id. Returns: result

transfer_playbackA

Transfer playback to a different device.

    Args:
        device_id: ID of the device to transfer to.
        play: Whether to start playing on the new device (default True).
    

Inputs: device_id (required), play. Returns: result

update_playlistB

Update a playlist's name, description, or visibility.

    Args:
        playlist_id: The Spotify ID of the playlist.
        name: New name for the playlist.
        description: New description for the playlist.
        public: Whether the playlist should be public.
    

Inputs: playlist_id (required), name, public, description. Returns: result

whoamiA

Diagnostic: show auth status, profile basics, active device, and configured scopes.

Inputs: no named parameters. Returns: result

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 47 tools

    Disambiguation4/5

    Tools target distinct resources and actions, but there are minor overlaps: get_playlist vs get_playlist_items and get_playback_state vs get_currently_playing could be confused, though descriptions clarify the differences.

    Naming Consistency4/5

    Mostly consistent snake_case with verb_noun (get_track, add_playlist_items), but some tools are single imperatives (play, pause, search) or use an adjective_noun form (next_track), slightly breaking the pattern.

    Tool Count2/5

    With 47 tools, the server far exceeds the recommended 3-15 range and crosses the 25+ threshold for 'too many', making it heavy and potentially overwhelming despite the broad Spotify domain.

    Completeness4/5

    Core CRUD for playlists, library, and playback is covered, but notable gaps remain such as no delete_playlist and no access to recommendations, audio features, or artist top tracks—minor omissions agents can work around.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers