Install spotatui

About spotatui

spotatui is a terminal-based Spotify client written in Rust. It provides a keyboard-driven interface for controlling Spotify playback, browsing your library, searching for music, and more, all from your terminal. Features include native streaming support, audio visualization, Discord Rich Presence, and media key integration.

What's new in 0.41.0

Added - MCP server: drive spotatui from your coding agent, with no API key (--features mcp-server): spotatui can expose your player and listening history as Model Context Protocol tools, so Claude Code, Codex, Gemini CLI, or any MCP client can act as your DJ — reading what you have been listening to, searching the catalogue, and queueing tracks. It rides the agent subscription you already have, so there is no key to configure and no LLM client compiled into spotatui. Setup is one line handed to your agent: point it at docs/mcp-setup.md, which is written as instructions for an agent to follow, and spotatui mcp status gives it a safe, machine-checkable probe of each step (never run spotatui mcp to test — that command is the server and blocks on stdin). Off by default: set behavior.mcp_enabled: true, and the socket binds loopback-only behind a token in ~/.config/spotatui/mcp.json. Written against protocol revision 2026-07-28 — which removed the initialize handshake and made MCP stateless — and dual-era, so it also answers initialize for the clients shipping today, which would otherwise fail outright against a modern-only server. Ask an agent for "songs like X" and a good recommender names tracks you already own, so search_tracks marks every result [owned] or [new] — Liked Songs plus playlists you own or collaborate on — which reaches the agent exactly when it is choosing, with no extra round trip. queue_tracks also takes exclude_owned: true for an agent that wants the guarantee rather than the hint; it reports what it skipped and substitutes nothing. Neither is on by default:...

Read release notes

Version history