JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 86
  • Score
    100M100P100Q54301F
  • License MIT

Spotify Web API MCP server for accessing music, artists, albums, and recommendations

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@thomaswawra/server-spotify) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    MCP Spotify Server

    A Model Context Protocol (MCP) server that provides access to the Spotify Web API. This server enables interaction with Spotify's music catalog, including searching for tracks, albums, and artists, as well as accessing artist-specific information like top tracks and related artists.

    Installation

    npx -y @thomaswawra/server-spotify

    Configuration

    Add to your MCP settings file (e.g., claude_desktop_config.json or cline_mcp_settings.json):

    {
      "mcpServers": {
        "spotify": {
          "command": "npx",
          "args": ["-y", "@thomaswawra/server-spotify"],
          "env": {
            "SPOTIFY_CLIENT_ID": "your_client_id",
            "SPOTIFY_CLIENT_SECRET": "your_client_secret"
          },
          "disabled": false,
          "autoApprove": []
        }
      }
    }

    You'll need to provide your Spotify API credentials:

    1. Go to Spotify Developer Dashboard
    2. Create a new application
    3. Get your Client ID and Client Secret
    4. Add them to the configuration as shown above

    Features

    • Search for tracks, albums, artists, and playlists
    • Get artist information including top tracks and related artists
    • Get album information and tracks
    • Access new releases and recommendations
    • Get audiobook information with market-specific content and chapters
    • Note: Audiobook endpoints may require additional authentication or market-specific access
    • Get and modify playlist information (name, description, public/private status)
    • Access playlist tracks and items with pagination support
    • Support for both Spotify IDs and URIs
    • Automatic token management with client credentials flow

    Available Tools

    • get_access_token: Get a valid Spotify access token
    • search: Search for tracks, albums, artists, or playlists
    • get_artist: Get artist information
    • get_artist_top_tracks: Get an artist's top tracks
    • get_artist_related_artists: Get artists similar to a given artist
    • get_artist_albums: Get an artist's albums
    • get_album: Get album information
    • get_album_tracks: Get an album's tracks
    • get_track: Get track information
    • get_new_releases: Get new album releases
    • get_recommendations: Get track recommendations
    • get_audiobook: Get audiobook information with optional market parameter
    • get_multiple_audiobooks: Get information for multiple audiobooks (max 50)
    • get_audiobook_chapters: Get chapters of an audiobook with pagination support (1-50 chapters per request)
    • get_playlist: Get a playlist owned by a Spotify user
    • get_playlist_tracks: Get full details of the tracks of a playlist (1-100 tracks per request)
    • get_playlist_items: Get full details of the items of a playlist (1-100 items per request)
    • modify_playlist: Change playlist details (name, description, public/private state, collaborative status)
    • add_tracks_to_playlist: Add one or more tracks to a playlist with optional position
    • remove_tracks_from_playlist: Remove one or more tracks from a playlist with optional positions and snapshot ID
    • get_current_user_playlists: Get a list of the playlists owned or followed by the current Spotify user (1-50 playlists per request)

    License

    MIT License