Which integrations are available for this server?

Provides 51 granular tools for controlling Spotify playback, managing playlists and library, searching for music, monitoring playback state, controlling devices and volume, and accessing detailed track, artist, and album information through the Spotify API.

How do I use Spotify MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Spotify MCP Server what's the current track name and artist?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Spotify MCP Server

by LLMTooling

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Spotify MCP Server

A comprehensive Model Context Protocol (MCP) server for Spotify

Provides 51 granular tools perfect for building dynamic HUDs, music visualizers, and AI-powered music control interfaces

Why This MCP Server?

This MCP server is specifically designed for dynamic HUD applications where you need individual data points. Instead of parsing large JSON responses, each tool returns exactly what you need.

Use Case	Traditional Approach	This Server
Get track name	Parse JSON → Extract `item.name`	`spotify_get_track_name` → Direct value
Get artist	Parse JSON → Extract `item.artists[0].name`	`spotify_get_artist_name` → Direct value
Show countdown timer	Parse JSON → Calculate remaining time → Format	`spotify_get_time_remaining_formatted` → "3:24"
Progress bar	Parse JSON → Calculate percentage	`spotify_get_track_progress_percentage` → "67"
Play/pause button	Parse JSON → Check `is_playing`	`spotify_is_playing` → "true" or "false"

Related MCP server: Spotify MCP Server

Complete Tool Coverage

51 tools organized into 9 categories for maximum flexibility

Category	Tool Count	Description
Bulk State Tools	2	Get complete playback state or track info in one call
Granular Track Info	16	Individual tools for artist, track name, album, duration, progress, artwork, and more
Granular Device Info	6	Get device name, type, volume, ID, and active status individually
Granular Playback State	5	Individual tools for play state, shuffle, repeat mode, and context
Playback Control	7	Play, pause, next, previous, seek, shuffle, and repeat controls
Volume & Device Control	2	Set volume and transfer playback between devices
Queue Management	3	View queue, add tracks, and see recently played
Search & Discovery	5	Search tracks, albums, artists, and get detailed information
Library Management	5	Manage saved tracks and playlists

Key Features

Feature	Description
Granular Data Access	51 specialized tools for precise data retrieval
HUD Optimized	Returns plain text values perfect for UI components
Production Ready	Comprehensive error handling and automatic token refresh
Full Test Coverage	94 tests covering all 51 tools and edge cases
Type Safe	Built with TypeScript and Zod schema validation
OAuth Authentication	Automatic token management and refresh
Zero Dependencies	Only requires Node.js 18+ and Spotify account

Installation

Step	Instructions
1. Prerequisites	• Node.js 18+ installed• Spotify Account (Premium recommended)• Spotify Developer App credentials
2. Get Credentials	1. Go to Spotify Developer Dashboard2. Create a new app3. Note your Client ID and Client Secret4. Add `http://localhost:8888/callback` to Redirect URIs
3. Install	`npm install`
4. Configure	Copy example env: `cp .env.example .env`Edit `.env` with credentials:`SPOTIFY_CLIENT_ID=your_idSPOTIFY_CLIENT_SECRET=your_secretSPOTIFY_REDIRECT_URI=http://localhost:8888/callback`
5. Authenticate	`npm run auth`(Opens browser to log in and saves tokens)
6. Build	`npm run build`
7. Configure Client	Add to `claude_desktop_config.json`:{ "mcpServers": { "spotify": { "command": "node", "args": ["/PATH/TO/dist/index.js"], "env": { ... } } }}

Usage

Once configured, restart your MCP client and you'll have access to all 51 tools!

Example Queries

Category	User Query	Tool Used
Dynamic HUDs	"What's the current track name?"	`spotify_get_track_name`
	"Get the artist"	`spotify_get_artist_name`
	"What's the time remaining?"	`spotify_get_time_remaining_formatted`
	"What's the playback progress percentage?"	`spotify_get_track_progress_percentage`
	"Is music playing?"	`spotify_is_playing`
Playback Control	"Pause the music"	`spotify_pause`
	"Skip to the next song"	`spotify_next`
	"Set volume to 50%"	`spotify_set_volume`
	"Enable shuffle"	`spotify_set_shuffle`
Discovery	"Search for tracks by The Beatles"	`spotify_search`
	"Add this song to my library"	`spotify_save_track`

Complete API Reference

Bulk State Tools (2)

Tool	Returns	Use Case
`spotify_get_playback_state`	Complete playback state (JSON)	Get all playback info at once
`spotify_get_current_track`	Complete track info (JSON)	Get all track info at once

Granular Track Info Tools (16)

Tool	Returns	Perfect For
`spotify_get_track_name`	Track name only	HUD track display
`spotify_get_artist_name`	Primary artist name	HUD artist display
`spotify_get_all_artists`	All artists (comma-separated)	Full artist credits
`spotify_get_album_name`	Album name only	HUD album display
`spotify_get_track_duration_ms`	Duration in milliseconds	Calculations
`spotify_get_track_duration_formatted`	Duration as "M:SS"	HUD duration display
`spotify_get_track_progress_ms`	Current position in ms	Calculations
`spotify_get_track_progress_formatted`	Current position as "M:SS"	HUD position display
`spotify_get_time_remaining_ms`	Time left in ms	Calculations
`spotify_get_time_remaining_formatted`	Time left as "M:SS"	HUD countdown timer
`spotify_get_track_progress_percentage`	Progress as 0-100	Progress bars
`spotify_get_track_uri`	Spotify URI	Playback control
`spotify_get_track_id`	Spotify ID	API calls
`spotify_get_album_art_url`	Album artwork URL	HUD artwork display
`spotify_get_track_explicit`	"true" or "false"	Explicit content indicator
`spotify_get_track_popularity`	Popularity 0-100	Track metrics

Granular Device Tools (6)

Tool	Returns	Perfect For
`spotify_get_device_name`	Device name	HUD device display
`spotify_get_device_type`	Device type	Device icons
`spotify_get_device_volume`	Volume 0-100	Volume displays
`spotify_get_device_id`	Device ID	Device switching
`spotify_is_device_active`	"true" or "false"	Active device indicator
`spotify_get_available_devices`	All devices (JSON)	Device selection

Granular Playback State Tools (5)

Tool	Returns	Perfect For
`spotify_is_playing`	"true" or "false"	Play/pause button states
`spotify_get_shuffle_state`	"true" or "false"	Shuffle button states
`spotify_get_repeat_mode`	"off", "track", or "context"	Repeat button states
`spotify_get_context_type`	Context type	Playlist/album indicators
`spotify_get_context_uri`	Context URI	Context switching

Playback Control Tools (7)

Tool	Parameters	Description
`spotify_play`	device_id?, context_uri?, uris?, position_ms?	Start/resume playback
`spotify_pause`	device_id?	Pause playback
`spotify_next`	device_id?	Skip to next track
`spotify_previous`	device_id?	Skip to previous track
`spotify_seek`	position_ms, device_id?	Seek to position
`spotify_set_shuffle`	state (bool), device_id?	Toggle shuffle
`spotify_set_repeat`	state (track/context/off), device_id?	Set repeat mode

Volume & Device Control Tools (2)

Tool	Parameters	Description
`spotify_set_volume`	volume_percent (0-100), device_id?	Set playback volume
`spotify_transfer_playback`	device_id, play?	Transfer playback to device

Queue Management Tools (3)

Tool	Parameters	Description
`spotify_get_queue`	-	Get current playback queue
`spotify_add_to_queue`	uri, device_id?	Add track to queue
`spotify_get_recently_played`	limit?	Get recently played tracks

Search & Discovery Tools (5)

Tool	Parameters	Description
`spotify_search`	query, type[], limit?	Search for tracks/albums/artists/playlists
`spotify_get_track_info`	track_id	Get detailed track information
`spotify_get_album_info`	album_id	Get detailed album information
`spotify_get_artist_info`	artist_id	Get detailed artist information
`spotify_get_artist_top_tracks`	artist_id, market?	Get artist's top tracks

Library Management Tools (5)

Tool	Parameters	Description
`spotify_get_saved_tracks`	limit?, offset?	Get user's saved tracks
`spotify_save_track`	track_id	Save (like) a track
`spotify_remove_saved_track`	track_id	Remove (unlike) a track
`spotify_get_playlists`	limit?, offset?	Get user's playlists
`spotify_get_playlist`	playlist_id	Get playlist details

Architecture

spotify-mcp-server/
├── src/
│   ├── auth/
│   │   ├── setup.ts              # OAuth authentication flow
│   │   └── token-manager.ts      # Token storage and refresh
│   ├── tools/
│   │   └── spotify-api.ts        # Spotify API wrapper
│   └── index.ts                  # Main MCP server with all 51 tools
├── tests/                        # Comprehensive test suite (94 tests)
├── dist/                         # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── eslint.config.mjs
└── .env                          # Your credentials (not committed)

Token Management

Token Details

Tokens are stored in spotify-tokens.json (automatically created)

Access tokens are automatically refreshed when they expire

You only need to run npm run auth once (or if tokens are revoked)

Tokens persist across server restarts

Error Handling

The server provides clear, actionable error messages:

Error Code	Meaning
401 Unauthorized	Re-run `npm run auth`
403 Forbidden	Feature may require Spotify Premium
404 Not Found	No active device or track
429 Rate Limit	Too many requests, wait a moment

Development

Task	Command
Run Tests	`npm test` (all)`npm run test:watch` (watch mode)`npm run test:coverage` (report)
Run Linter	`npm run lint`
Clean Build	`npm run clean && npm run build`
Debugging	Server logs to stderr

Use Cases

Dynamic HUD Applications

Perfect for creating real-time music displays:

// Get individual values for your HUD components
const trackName = await callTool("spotify_get_track_name");
const artist = await callTool("spotify_get_artist_name");
const progress = await callTool("spotify_get_track_progress_percentage");
const timeRemaining = await callTool("spotify_get_time_remaining_formatted");
const isPlaying = await callTool("spotify_is_playing");
const albumArt = await callTool("spotify_get_album_art_url");

Music Visualizers

Get precise timing and state info:

const progressMs = await callTool("spotify_get_track_progress_ms");
const durationMs = await callTool("spotify_get_track_duration_ms");
const isPlaying = await callTool("spotify_is_playing");

AI Music Assistants

Natural language control:

User: "What's playing?"
AI: Uses spotify_get_track_name and spotify_get_artist_name

User: "How much time is left?"
AI: Uses spotify_get_time_remaining_formatted

User: "Skip this song"
AI: Uses spotify_next

Available Tools

51 tools

spotify_add_to_queueB

Add a track to the user's playback queue.

Inputs: uri (required), device_id.

spotify_get_album_art_urlA

Get ONLY the URL of the album artwork for the currently playing track. Returns the largest available image URL - perfect for displaying in HUDs.

Inputs: no named parameters.

spotify_get_album_infoB

Get detailed information about a specific album by its Spotify ID.

Inputs: album_id (required).

spotify_get_album_nameA

Get ONLY the album name of the currently playing track. Returns plain text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_all_artistsA

Get all artist names of the currently playing track (comma-separated). Returns plain text.

Inputs: no named parameters.

spotify_get_artist_infoB

Get detailed information about a specific artist by their Spotify ID.

Inputs: artist_id (required).

spotify_get_artist_nameA

Get ONLY the primary artist name of the currently playing track. Returns plain text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_artist_top_tracksC

Get an artist's top tracks.

Inputs: artist_id (required), market.

spotify_get_available_devicesA

Get a list of all available Spotify devices. Returns JSON array of devices with their details.

Inputs: no named parameters.

spotify_get_context_typeA

Get ONLY the type of playback context (album, artist, playlist, etc.). Returns context type as text.

Inputs: no named parameters.

spotify_get_context_uriA

Get ONLY the URI of the playback context (album, playlist, etc.). Returns URI as text.

Inputs: no named parameters.

spotify_get_current_trackB

Get complete information about the currently playing track, including all metadata. Returns comprehensive JSON data.

Inputs: market.

spotify_get_device_idA

Get ONLY the ID of the currently active playback device. Returns ID as text.

Inputs: no named parameters.

spotify_get_device_nameA

Get ONLY the name of the currently active playback device. Returns plain text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_device_typeA

Get ONLY the type of the currently active playback device (Computer, Smartphone, Speaker, etc.). Returns plain text.

Inputs: no named parameters.

spotify_get_device_volumeA

Get ONLY the current volume percentage of the active device (0-100). Returns number as text - perfect for volume displays.

Inputs: no named parameters.

spotify_get_playback_stateA

Get complete information about the user's current playback state, including track, artist, album, progress, device, and all settings. Returns comprehensive JSON data.

Inputs: market.

spotify_get_playlistB

Get detailed information about a specific playlist.

Inputs: playlist_id (required).

spotify_get_playlistsC

Get the user's playlists.

Inputs: limit, offset.

spotify_get_queueA

Get the user's current playback queue, including currently playing and upcoming tracks.

Inputs: no named parameters.

spotify_get_recently_playedB

Get tracks from the user's recently played history.

Inputs: limit.

spotify_get_repeat_modeA

Get ONLY the current repeat mode. Returns 'off', 'track', or 'context' as text - perfect for repeat button states in HUDs.

Inputs: no named parameters.

spotify_get_saved_tracksB

Get the user's saved (liked) tracks.

Inputs: limit, offset.

spotify_get_shuffle_stateA

Get ONLY whether shuffle is enabled. Returns 'true' or 'false' as text - perfect for shuffle button states in HUDs.

Inputs: no named parameters.

spotify_get_time_remaining_formattedA

Get ONLY the time remaining in the current track in formatted time (M:SS or H:MM:SS). Returns formatted text - perfect for HUD countdown displays.

Inputs: no named parameters.

spotify_get_time_remaining_msA

Get ONLY the time remaining in the current track in milliseconds. Returns number as text - perfect for countdown timers.

Inputs: no named parameters.

spotify_get_track_duration_formattedA

Get ONLY the total duration of the current track in formatted time (M:SS or H:MM:SS). Returns formatted text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_track_duration_msA

Get ONLY the total duration of the current track in milliseconds. Returns number as text.

Inputs: no named parameters.

spotify_get_track_explicitA

Get ONLY whether the current track is explicit. Returns 'true' or 'false' as text.

Inputs: no named parameters.

spotify_get_track_idA

Get ONLY the Spotify ID of the currently playing track. Returns ID as text.

Inputs: no named parameters.

spotify_get_track_infoA

Get detailed information about a specific track by its Spotify ID.

Inputs: track_id (required).

spotify_get_track_nameA

Get ONLY the name of the currently playing track. Returns plain text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_track_popularityA

Get ONLY the popularity score of the current track (0-100). Returns number as text.

Inputs: no named parameters.

spotify_get_track_progress_formattedA

Get ONLY the current playback position in formatted time (M:SS or H:MM:SS). Returns formatted text - perfect for HUD displays.

Inputs: no named parameters.

spotify_get_track_progress_msA

Get ONLY the current playback position in milliseconds. Returns number as text.

Inputs: no named parameters.

spotify_get_track_progress_percentageA

Get ONLY the playback progress as a percentage (0-100). Returns number as text - perfect for progress bars in HUDs.

Inputs: no named parameters.

spotify_get_track_uriA

Get ONLY the Spotify URI of the currently playing track. Returns URI as text.

Inputs: no named parameters.

spotify_is_device_activeA

Get ONLY whether a device is currently active. Returns 'true' or 'false' as text.

Inputs: no named parameters.

spotify_is_playingA

Get ONLY whether music is currently playing. Returns 'true' or 'false' as text - perfect for play/pause button states in HUDs.

Inputs: no named parameters.

spotify_nextB

Skip to the next track in the user's queue.

Inputs: device_id.

spotify_pauseB

Pause playback on the user's account.

Inputs: device_id.

spotify_playB

Start or resume playback. Can optionally specify device, context (album/playlist URI), specific tracks, or starting position.

Inputs: uris, device_id, context_uri, position_ms.

spotify_previousA

Skip to the previous track in the user's queue.

Inputs: device_id.

spotify_remove_saved_trackB

Remove (unlike) a track from the user's library.

Inputs: track_id (required).

spotify_save_trackB

Save (like) a track to the user's library.

Inputs: track_id (required).

spotify_searchC

Search for tracks, albums, artists, or playlists on Spotify.

Inputs: type (required), query (required), limit.

spotify_seekB

Seek to a specific position in the currently playing track.

Inputs: position_ms (required), device_id.

spotify_set_repeatB

Set the repeat mode for playback.

Inputs: state (required), device_id.

spotify_set_shuffleC

Toggle shuffle mode on or off.

Inputs: state (required), device_id.

spotify_set_volumeC

Set the volume for the user's current playback device.

Inputs: volume_percent (required), device_id.

spotify_transfer_playbackB

Transfer playback to a different device.

Inputs: device_id (required), play.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3.4/5.0

Scored 2026-07-13 08:05 across 51 tools

Disambiguation5/5

Each tool has a clearly distinct purpose, with very specific actions and targets. Even though there are many tools for retrieving individual attributes of the current track, their names and descriptions unambiguously indicate what each returns.

Naming Consistency5/5

All tools follow the consistent pattern 'spotify_verb_noun' (e.g., spotify_get_track_name, spotify_set_volume). There are no mixed conventions or deviations.

Tool Count2/5

With 51 tools, the set is overly large for the domain. Many granular getters (e.g., spotify_get_track_name, spotify_get_track_id) could be consolidated into fewer tools, making the surface bloated and harder to navigate.

Completeness3/5

The set covers playback control, current state, search, and basic library management well, but lacks playlist creation/modification and other common operations like following artists or user profile retrieval. Some gaps remain.

Resources

Related MCP Connectors

Spotify
io.github.akutishevsky
Full Spotify Web API coverage - albums, artists, playlists, player controls, and more.
Entertainment & Media App Automation
2
https://sptfy-mcp.online/mcp
spotifyD
com.jojapi
Spotify: Spotify Data API for Millions of songs & podcasts, artists, albums, playlists and more.
Entertainment & Media Search
371
https://mcp.jojapi.com/spotify
Spotify DataA
cc.checkleaked
Spotify play counts, monthly listeners, charts, artist stats, albums, playlists and ISRC lookup.
Entertainment & Media Search
1311
https://spotify-proxy.checkleaked.cc/mcp
Spotify Play Count MCP: Plays & Monthly Listeners
io.github.GeminiGeorge22
Spotify play counts for any track, album, artist or playlist, plus monthly listeners and followers.
Entertainment & Media
1
https://mcp.apify.com?tools=publicrecords/spotify-play-count-scraper

Related MCP Servers

Spotify MCP Server
Entertainment & Media App Automation
rakshitha2207
A
license
Not graded
quality
D
maintenance
Integrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
Updated 2 years ago (2025-03-17 17:33 UTC)
133 npm
MIT
Spotify MCP Server
Entertainment & Media App Automation
EvansLR
F
license
A
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.
Updated a year ago (2025-12-03 03:30 UTC)
11
1
-
Spotify MCP Server (Python)
Entertainment & Media Search
argotdev
F
license
Not graded
quality
D
maintenance
Enables interaction with Spotify through MCP, providing tools for searching tracks, artists, albums, playlists, and accessing user data like top tracks and recently played.
Updated a year ago (2025-10-06 19:22 UTC)
-
spotify-mcp-server
Entertainment & Media Search
freddy24-7
F
license
A
quality
D
maintenance
Exposes Spotify controls as MCP tools for playback, playlist management, and AI playlist generation; includes a web app and supports multi-user profiles.
Updated 8 months ago (2026-03-18 09:37 UTC)
14
-

Spotify MCP Server

Why This MCP Server?

Complete Tool Coverage

Key Features

Installation

Usage

Example Queries

Complete API Reference

Bulk State Tools (2)

Granular Track Info Tools (16)

Granular Device Tools (6)

Granular Playback State Tools (5)

Playback Control Tools (7)

Volume & Device Control Tools (2)

Queue Management Tools (3)

Search & Discovery Tools (5)

Library Management Tools (5)

Architecture

Token Management

Error Handling

Development

Use Cases

Dynamic HUD Applications

Music Visualizers

AI Music Assistants

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

Spotify MCP Server

Spotify MCP Server

Spotify MCP Server (Python)

spotify-mcp-server