spotify-mcp-web

Soundtrack Curator & Staging Studio — a self-hosted FastAPI web application for Spotify playlist curation, TMDB filmography browsing, and MCP tools management. Pairs with spotify-soundtrack-mcp.

Installation

pip install spotify-mcp-web

Quick Start

1. Configure credentials

Create a .env file in your working directory:

# Spotify Developer App credentials (PKCE — no secret needed!)
SPOTIPY_CLIENT_ID=your_spotify_client_id_here
SPOTIPY_REDIRECT_URI=http://127.0.0.1:8888/callback

# TMDB (optional, enables cinema/filmography features)
TMDB_API_KEY=your_tmdb_api_key_here

Important: In your Spotify Developer Dashboard, add http://127.0.0.1:8888/callback as a Redirect URI.

2. Start the Studio

soundtrack-studio

This starts the web app at http://127.0.0.1:8000 and opens it in your browser automatically.

Features

• 🎬 Cinema Filmography — Search actors/movies via TMDB and build soundtracks automatically
• 🎵 Playlist Curation — Create, merge, deduplicate, sort, split, and export Spotify playlists
• 🎚️ Playback Controls — Control Spotify Connect devices, queue management, volume/shuffle/repeat
• 📊 Taste Analytics — Top tracks, artists, listening patterns, playlist comparisons
• 📚 Library Management — Saved tracks & albums, library browsing
• 🔍 Catalog Browsing — Artist, album, and track lookup

Environment Variables

Running as a Remote Server

HOST=0.0.0.0 PORT=8080 OPEN_BROWSER=false soundtrack-studio

Pairing with the MCP Agent

Install both packages to get the full experience:

pip install spotify-soundtrack-mcp spotify-mcp-web

• spotify-mcp — starts the agent (for Claude Desktop / Cursor)
• soundtrack-studio — starts the web UI

Links

• GitHub Repository
• MCP Agent Package (spotify-soundtrack-mcp)
• Report Issues