# Spotify

Spotify Web API. Browse music, manage playlists, control playback, and explore listening history.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add arjunkmrm/spotify

# Browse available tools
npx -y @smithery/cli@latest tool list arjunkmrm/spotify

# Get full schema for a tool
npx -y @smithery/cli@latest tool get arjunkmrm/spotify albums.get

# Call a tool
npx -y @smithery/cli@latest tool call arjunkmrm/spotify albums.get '{}'
```

## Direct MCP Connection

Endpoint: `https://spotify--arjunkmrm.run.tools`

## Tools (46)

- `albums.get` — Get Spotify catalog information for a single album.
- `albums.tracks.list` — Get Spotify catalog information about an album’s tracks.
- `artists.get` — Get Spotify catalog information for a single artist identified by their unique Spotify ID.
- `artists.albums.list` — Get Spotify catalog information about an artist's albums.
- `shows.get` — Get Spotify catalog information for a single show identified by its
- `shows.episodes.list` — Get Spotify catalog information about an show’s episodes. Optional parameters can be used to limit the number of episod…
- `episodes.get` — Get Spotify catalog information for a single episode identified by its
- `audiobooks.get` — Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Irelan…
- `audiobooks.chapters.list` — Get Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada,…
- `me.audiobooks.list` — Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.
- `chapters.get` — Get Spotify catalog information for a single audiobook chapter. Chapters are only available within the US, UK, Canada, …
- `tracks.get` — Get Spotify catalog information for a single track identified by its
- `search.list` — Get Spotify catalog information about albums, artists, playlists, tracks, shows, episodes or audiobooks
- `me.list` — Get detailed profile information about the current user (including the
- `playlists.get` — Get a playlist owned by a Spotify user.
- `playlists.update` — Change a playlist's name and public/private state. (The user must, of
- `playlists.items.list` — Get full details of the items of a playlist owned by a Spotify user.
- `playlists.items.create` — Add one or more items to a user's playlist.
- `playlists.items.update` — Either reorder or replace items in a playlist depending on the request's parameters.
- `playlists.items.delete` — Remove one or more items from a user's playlist.
- `me.playlists.list` — Get a list of the playlists owned or followed by the current Spotify
- `me.playlists.create` — Create a playlist for the current Spotify user. (The playlist will be empty until
- `me.library.update` — Add one or more items to the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audioboo…
- `me.library.delete` — Remove one or more items from the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, aud…
- `me.library.contains.list` — Check if one or more items are already saved in the current user's library. Accepts Spotify URIs for tracks, albums, ep…
- `me.albums.list` — Get a list of the albums saved in the current Spotify user's 'Your Music' library.
- `me.tracks.list` — Get a list of the songs saved in the current Spotify user's 'Your Music' library.
- `me.episodes.list` — Get a list of the episodes saved in the current Spotify user's library.
- `me.shows.list` — Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of…
- `me.top.get` — Get the current user's top artists or tracks based on calculated affinity.
- `me.following.list` — Get the current user's followed artists.
- `me.player.list` — Get information about the user’s current playback state, including track or episode, progress, and active device.
- `me.player.update` — Transfer playback to a new device and optionally begin playback. This API only works for users who have Spotify Premium…
- `me.player.devices.list` — Get information about a user’s available Spotify Connect devices. Some device models are not supported and will not be …
- `me.player.currently_playing.list` — Get the object currently being played on the user's Spotify account.
- `me.player.play.update` — Start a new context or resume current playback on the user's active device. This API only works for users who have Spot…
- `me.player.pause.update` — Pause playback on the user's account. This API only works for users who have Spotify Premium. The order of execution is…
- `me.player.next.create` — Skips to next track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution…
- `me.player.previous.create` — Skips to previous track in the user’s queue. This API only works for users who have Spotify Premium. The order of execu…
- `me.player.seek.update` — Seeks to the given position in the user’s currently playing track. This API only works for users who have Spotify Premi…
- `me.player.repeat.update` — Set the repeat mode for the user's playback. This API only works for users who have Spotify Premium. The order of execu…
- `me.player.volume.update` — Set the volume for the user’s current playback device. This API only works for users who have Spotify Premium. The orde…
- `me.player.shuffle.update` — Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of exec…
- `me.player.recently_played.list` — Get tracks from the current user's recently played tracks.
- `me.player.queue.list` — Get the list of objects that make up the user's queue.
- `me.player.queue.create` — Add an item to be played next in the user's current playback queue. This API only works for users who have Spotify Prem…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get arjunkmrm/spotify <tool-name>
```
