Spotify MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration between AI assistants (like Claude Desktop) and the Spotify Web API. This server enables AI assistants to interact with Spotify's music streaming service through a well-structured, type-safe interface.

🎵 Overview

This MCP server acts as a bridge between AI assistants and Spotify's Web API, allowing users to:

Search for music, artists, albums, and playlists
Control playback (play, pause, skip, volume control)
Manage playlists (create, modify, add/remove tracks)
Access user profiles and music libraries
Manage user's music library (save/remove tracks)
Get user's listening history and top content
Retrieve plain text song lyrics

✨ Key Features

🛠️ 29 Comprehensive Tools across 7 categories:

Albums (4 tools): Album information and new releases
Artists (6 tools): Artist data, top tracks, and discovery
Tracks (8 tools): Track details, lyrics, and library management
Playlists (10 tools): Complete playlist management and discovery
Playback (10 tools): Full player control and device management
User (1 tool): User profile information
Search (2 tools): General search and search-to-play functionality

🏗️ Clean Architecture:

Modular Design: Feature-based tool organization
Type Safety: Full TypeScript implementation with Zod validation
Reusable Components: Common schema builders eliminate code duplication
Automatic Registration: Tools are automatically discovered and registered
Error Handling: Comprehensive error management with descriptive messages

🔧 Developer Experience:

Easy Extension: Simple pattern for adding new tools
Maintainable Code: Clear separation of concerns
Documentation: Self-documenting schema definitions
Debugging: Detailed logging and error reporting

🚀 Quick Start

1. Clone and Install

git clone <repository-url>
cd Spotify-OAuth-MCP-server
npm install

2. Get Spotify Access Token

3. Build and Start

# Build the TypeScript code
npm run build

# Start the MCP server
npm start

# For development with auto-reload
npm run dev

🔧 Claude Desktop Integration

To use this MCP server with Claude Desktop, add it to your MCP configuration:

macOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json`

Windows: `%APPDATA%\Claude\claude_desktop_config.json`

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/path/to/your/project/src/mcp/server.js"]
    }
  }
}

📖 Usage Examples

Once integrated with Claude Desktop, you can use natural language commands:

"Play my Discover Weekly playlist"
"Search for songs by The Beatles"
"Add this song to my favorites"
"Skip to the next track"
"Create a new playlist called 'Morning Vibes'"
"Search for playlists with chill music"
"Show me my top artists this month"
"What's currently playing?"
"Add this song to my queue"
"Get my recently played tracks"
"Show me the lyrics for this song"
"Get the plain text lyrics for analysis"

🏗️ Project Architecture

src/
├── mcp/
│   ├── server.ts              # Main MCP server entry point
│   ├── helpers/
│   │   └── utils.ts          # Utility functions and helpers
│   ├── schemas/
│   │   └── common.ts         # Reusable schema builders
│   └── tools/
│       ├── index.ts          # Tool registry and registration system
│       ├── albums.ts         # Album-related tools (4 tools)
│       ├── artists.ts        # Artist-related tools (6 tools)
│       ├── tracks.ts         # Track-related tools (8 tools)
│       ├── playlists.ts      # Playlist management tools (10 tools)
│       ├── playback.ts       # Playback control tools (10 tools)
│       ├── user.ts           # User profile tools (1 tool)
│       └── search.ts         # Search functionality tools (2 tools)
└── spotify.ts                # Spotify Web API service class

Architecture Benefits

Modularity: Each tool category is self-contained
Type Safety: Full TypeScript and Zod validation throughout
Reusability: Common schemas prevent code duplication
Scalability: Easy to add new tools and categories
Maintainability: Clear separation of concerns
Performance: Efficient registration and validation

🛠️ Available Tools

Albums (4 tools)

get_album: Retrieve detailed album information
get_album_tracks: Get tracks from a specific album
get_new_releases: Discover new album releases
search_albums: Search for albums by keywords

Artists (6 tools)

get_artist: Get detailed artist information
get_artist_albums: Retrieve artist's albums
get_artist_top_tracks: Get artist's most popular tracks
search_artists: Search for artists by keywords
get_followed_artists: Get user's followed artists
get_top_artists: Get user's top artists

Tracks (8 tools)

get_track: Get detailed track information
search_tracks: Search for tracks by keywords
get_liked_tracks: Get user's saved/liked tracks
save_tracks: Add tracks to user's library
remove_tracks: Remove tracks from user's library
get_top_tracks: Get user's top tracks
get_recently_played: Get recently played tracks
get_track_lyrics: Get plain text lyrics for tracks

Playlists (10 tools)

get_playlist: Retrieve playlist details
get_user_playlists: Get user's playlists
get_playlist_tracks: Get tracks from a playlist
create_playlist: Create a new playlist
add_to_playlist: Add tracks to a playlist
remove_from_playlist: Remove tracks from a playlist
search_playlists: Search for playlists by keywords
get_categories: Get browse categories
save_playlist: Follow/save a user-created playlist
unsave_playlist: Unfollow/unsave a playlist

Playback (10 tools)

get_currently_playing: Get current playback information
start_playback: Start music playback
resume_player: Resume paused playback
pause_player: Pause current playback
skip_to_next: Skip to next track
skip_to_previous: Skip to previous track
set_volume: Adjust playback volume
add_to_queue: Add song to playback queue
get_devices: Get available playback devices
transfer_playback: Switch playback between devices

User (1 tool)

get_user_profile: Get current user's profile information

Search (2 tools)

search_music: Search for tracks, artists, albums, or playlists
search_and_play_music: Search for content and immediately start playback

Happy Music Streaming with AI! 🎵🤖

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that enables AI assistants like Claude Desktop to interact with Spotify's music streaming service, supporting playback control, playlist management, music search, and user profile access.

Related MCP Servers

Spotify MCP Server
marcelmarais
A
security
F
license
A
quality
A lightweight Model Context Protocol server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.
Last updated -
12
105
TypeScript
Spotify MCP Server
obre10off
-
security
F
license
-
quality
A Model Context Protocol server that enables controlling Spotify playback through natural language commands in MCP clients like Cursor or Claude for Desktop.
Last updated -
2
TypeScript
Vulpes Spotify MCP Server
ejfox
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Spotify, allowing them to search for tracks, control playback, and manage playlists.
Last updated -
1
TypeScript
Spotify MCP Server
rakshitha2207
-
security
F
license
-
quality
Integrates with Spotify Web API through the Model Context Protocol, allowing users to search tracks, control playback, and manage playlists programmatically.
Last updated -
JavaScript

View all related MCP servers

Spotify MCP Server