mcp-spotify MCP Server

A powerful Model Context Protocol (MCP) server that provides access to the Spotify Web API. ArtistLens enables seamless interaction with Spotify's music catalog, including searching for tracks, albums, and artists, as…

Local serverstdioMIT

What is the mcp-spotify MCP Server?

mcp-spotify source profile. From the maintainer documentation: “A powerful Model Context Protocol (MCP) server that provides access to the Spotify Web API. ArtistLens enables seamless 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

The documented npm package is @thomaswawra/artistlens. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares SPOTIFY_CLIENT_ID, SPOTIFY_CLIENT_SECRET. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_access_tokenGet a valid Spotify access token
searchSearch for tracks, albums, artists, or playlists
get_artistGet artist information
get_artist_top_tracksGet an artist's top tracks
get_artist_related_artistsGet artists similar to a given artist
get_artist_albumsGet an artist's albums
get_albumGet album information
get_album_tracksGet an album's tracks
get_trackGet track information
get_available_genresGet a list of available genres for recommendations
get_new_releasesGet new album releases
get_recommendationsGet track recommendations based on seed tracks, artists, or genres
get_audiobookGet audiobook information with optional market parameter
get_multiple_audiobooksGet information for multiple audiobooks (max 50)
get_audiobook_chaptersGet chapters of an audiobook with pagination support (1-50 chapters per request)
get_playlistGet a playlist owned by a Spotify user
get_playlist_tracksGet full details of the tracks of a playlist (1-100 tracks per request)
get_playlist_itemsGet full details of the items of a playlist (1-100 items per request)
modify_playlistChange playlist details (name, description, public/private state, collaborative status)
add_tracks_to_playlistAdd one or more tracks to a playlist with optional position
remove_tracks_from_playlistRemove one or more tracks from a playlist with optional positions and snapshot ID
get_current_user_playlistsGet a list of the playlists owned or followed by the current Spotify user (1-50 playlists per request)
get_featured_playlistsGet a list of Spotify featured playlists with optional locale and pagination support
get_category_playlistsGet a list of Spotify playlists tagged with a particular category

How to install the mcp-spotify MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
SPOTIFY_CLIENT_IDDeclared in the maintainer’s client configuration.Check documentation
SPOTIFY_CLIENT_SECRETDeclared in the maintainer’s client configuration.Check documentation