Skip to content
Open Source CLI

Control Spotify
from your AI Agent

Secure, agent (and human) friendly CLI for playback, search, playlists, and library management. JSON output. PKCE auth.

$ spotify search "Kind of Blue" --type album
{ "albums": [{ "name": "Kind of Blue", ... }] }
$ spotify play --uri spotify:album:1weenld61qoidwYuZ1GESA
{ "status": "playing" }

Agent-Friendly

Every command outputs structured JSON — perfect for LLM agents, scripts, and automation pipelines. No parsing needed.

JSON-First Output

Structured JSON to stdout, errors to stderr. Machine-readable exit codes for every failure type.

Secure PKCE Auth

No client secret needed. Browser-based OAuth with PKCE, automatic token refresh, and secure local storage.

MIT Licensed. Not affiliated with or endorsed by Spotify AB.