# Sonoscli

> Control Sonos speakers on the local network with commands for playback, grouping, favorites, queue, and Spotify search.

- Skill: `comeonoliver/sonoscli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add comeonoliver/sonoscli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/comeonoliver/sonoscli/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, Coding & Dev Tools
- Tags: Cli, Music, Sonos, Speakers, Spotify
- Author: ComeOnOliver (https://skillmd.com/u/comeonoliver)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/comeonoliver/sonoscli

---

# Sonos CLI

Use `sonos` to control Sonos speakers on the local network.

Quick start

- `sonos discover`
- `sonos status --name "Kitchen"`
- `sonos play|pause|stop --name "Kitchen"`
- `sonos volume set 15 --name "Kitchen"`

Common tasks

- Grouping: `sonos group status|join|unjoin|party|solo`
- Favorites: `sonos favorites list|open`
- Queue: `sonos queue list|play|clear`
- Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`

Notes

- If SSDP fails, specify `--ip <speaker-ip>`.
- Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.