Sonoscli

If you have Sonos speakers at home and want Claude to control them directly, this is your tool. It handles discovery via SSDP, playback controls, volume adjustment, and speaker grouping all through the local network. The CLI supports Spotify search through SMAPI and manages favorites and queues. One catch: on macOS in direct mode, you'll need to fiddle with Local Network permissions for whatever parent process runs your gateway, whether that's node, Terminal, or VS Code. The troubleshooting section is unusually thorough about network permission errors, which you'll appreciate when SSDP decides to be temperamental. Best suited for home automation scenarios where you want conversational control over your speakers without reaching for the Sonos app.

skills.sh installs: 2.8K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill sonoscli --agent claude-code

Installs into .claude/skills of the current project.

Files

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.
If there is an error, check the troubleshooting section and offer advice if there is a decent match.