Skip to main content
Glama
raksix

spotify-mcp

by raksix
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

spotify-mcp

Spotify Web API'yı MCP olarak Hermes'e bağlayan sunucu. Computer use / UI otomasyonu yok — her şey resmi Spotify Web API ile. Windows, macOS ve Linux'ta çalışır; hesaptaki hangi cihaz aktifse (desktop, telefon, web) onu kontrol eder.

Özellikler

  • ▶️ Şarkı/albüm/sanatçı/playlist ara & çal

  • ⏸️ Duraklat / devam et / ileri / geri

  • 🔊 Ses seviyesi (0-100)

  • ⏭️ Sıraya ekle (queue)

  • 📱 Aktif cihazları listele, çalan şarkıyı göster

Related MCP server: Spotify MCP Server

Kurulum

1. Spotify Developer App oluştur

  1. https://developer.spotify.com/dashboard adresine gir → Create app

  2. App name/description doldur, Redirect URI olarak şunu ekle:

    http://127.0.0.1:8890/callback

  3. Client ID'yi (ve varsa Client Secret'ı) kopyala.

2. Config yaz

mkdir -p ~/.spotify-mcp

~/.spotify-mcp/config.json:

{
  "clientId": "SENIN_CLIENT_ID",
  "clientSecret": "SENIN_CLIENT_SECRET"
}

3. OAuth (bir kere)

node auth.js

Tarayıcı açılır, Spotify'a girip Agree'e basarsın, token ~/.spotify-mcp/tokens.json'a kaydedilir. Refresh token otomatik yenilenir.

4. Hermes'e ekle

printf 'Y\n' | hermes mcp add spotify --command node --args C:/Users/<user>/Documents/GitHub/spotify-mcp/server.js
hermes mcp ls
hermes mcp test spotify

MCP tool'ları yeni oturumlarda yüklenir — ekledikten sonra yeni bir sohbet başlat.

Tool'lar

Tool

Açıklama

spotify_play_track(query[, device])

Şarkı ara & hemen çal

spotify_play_artist(name[, device])

Sanatçı çal

spotify_play_album(query[, device])

Albüm çal

spotify_play_playlist(name[, device])

Playlist çal

spotify_play_uri(uri[, device])

Direkt spotify: URI çal

spotify_queue_track(query)

Sıraya ekle

spotify_pause / spotify_resume([device])

Duraklat / devam

spotify_next / spotify_previous

İleri / geri

spotify_set_volume(percent[, device])

Ses 0-100

spotify_playback_state

Ne çalıyor, hangi cihazda

spotify_list_devices

Aktif cihazlar (id'leriyle)

spotify_search(query, type)

Arama

spotify_auth_status

Auth durumu

device = cihaz adı. Önce tam eşleşme aranır (örn. "FURKAN" → Windows PC), tam eşleşme yoksa alt dize (örn. "Macbook" → "Furkan Macbook Air"). Dikkat: "FURKAN" aynı zamanda "Furkan Macbook Air"in alt dizesi — bu yüzden tam eşleşme önceliklidir! Verilmezse aktif cihazda çalar. Cihaz değişiminde aktif cihaz önce pause edilir (~7sn oturum bırakma süresi), sonra hedefe play edilir.

Notlar

  • Playback kontrolü (play/pause/skip/volume) Premium hesap gerektirir (Spotify kuralı). Arama ve auth her hesapta çalışır.

  • Playback, hesabında aktif olan cihaza gider. Cihaz yoksa: Spotify'ı aç, bir şarkı başlat, sonra tekrar dene.

  • Sıfır npm bağımlılığı — Node >= 18 yeterli.

Test (probe)

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}\n' | node server.js

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Spotify Streamable MCP Server

    iceener
    A
    license
    -
    quality
    C
    maintenance
    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.
    Last updated
    24
    80
    ISC

  • Spotify MCP Server

    EvansLR
    F
    license
    -
    quality
    D
    maintenance
    Enables control of Spotify playback through OAuth authentication, including play/pause, track navigation, volume control, device management, and searching/playing songs by artist or track name.
    Last updated
    1

  • Spotify API MCP

    fisknils
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with Spotify through OAuth 2.0 authentication, supporting search for tracks/artists/albums/playlists, user profile access, and playlist management including creation and adding tracks.
    Last updated
    6

View all related MCP servers

Related MCP Connectors

  • Spotify

    Spotify MCP — Web API via client_credentials OAuth

  • musicbrainz-mcp-server

    Search MusicBrainz artists, releases, works, labels; resolve ISRC/ISWC/barcode; fetch cover art.

  • Deezer

    Deezer public music catalog (search/tracks/albums/artists/charts)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/raksix/spotify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server