Authentication and documentation improvements

What's Changed

• chore: add repository topics and SEO heading by @vsaez in #59
• Enforce user OAuth tokens and safer refresh handling by @vsaez in #62
• Feat/automatic spotify oath flow by @vsaez in #68
• Feat/automatic spotify oath flow by @vsaez in #69
• Remove impoved_readme.md by @vsaez in #70
• feat/include hero gif by @vsaez in #71
• Changes references of github by @vsaez in #72
• Add badges by @vsaez in #73

Full Changelog: v0.1.0...v0.2.0

First release: MCP Spotify playback working

mcp-spotify-player: a local Model Context Protocol (MCP) server to control Spotify from MCP clients (e.g., Claude).
GitHub

✨ Features

Playback: play, pause, next/previous, playback state, devices, volume (0–100), repeat (off/context/track).
GitHub

Queue: add to queue and list upcoming tracks.
GitHub

Search: tracks, artists, albums; plus collection search for public playlists/albums.
GitHub

Albums: single/multiple album details and album tracks.
GitHub

Artists: artist info, artist albums, top tracks.
GitHub

Library (saved albums): list, check, save, and remove.
GitHub

Playlists: list playlists, get tracks, create, rename, clear, add tracks.
GitHub

Diagnostics: diagnose tool for auth/environment checks.
GitHub

MCP stdio server: JSON-RPC over stdio; direct integration with Claude.
GitHub

🧰 Commands (highlights)

play_music, pause_music, skip_next, skip_previous, set_volume, set_repeat,
get_current_playing, get_playback_state, get_devices, search_music, search_collections,
get_playlists, get_playlist_tracks, create_playlist, rename_playlist, clear_playlist, add_tracks_to_playlist,
get_artist, get_artist_albums, get_artist_top_tracks,
get_album, get_albums, get_album_tracks,
get_saved_albums, check_saved_albums, save_albums, delete_saved_albums,
queue_add, queue_list, diagnose.
GitHub

🔐 Auth & Scopes

Configure via .env and store tokens at ~/.config/mcp_spotify_player/tokens.json (override with MCP_SPOTIFY_TOKENS_PATH).

Required scopes include playback, playlists, and library access (see README for the full list).
GitHub

⚙️ Install & Run

Python 3.10+. Install with pip install . (dev: pip install -e .).

Run the stdio server with mcp-spotify-player or python -m mcp_spotify_player.