How do I install the Sonos CLI (sonoscli) skill?

Run npx skillmds@latest add composiohq/sonos-cli-sonoscli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Sonos CLI (sonoscli) safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sonos CLI (sonoscli)?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Sonos CLI (sonoscli) free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Sonos CLI (sonoscli)?

Composio HQ (@composiohq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sonos CLI (sonoscli) by composiohq — Agent Skill

Name: Sonos CLI (sonoscli)
Author: Composio HQ

Sonos CLI (sonoscli)

CLI to discover and control Sonos speakers over local network — playback, grouping, queue, favorites, scenes, Spotify, and volume. Use when an agent needs to control music playback, manage speaker groups, or play Spotify on Sonos.

Composio HQ 91c076c 3.2 KB Updated Sep 17, 2026 66.9k repo stars

File contents

sonoscli — Control Sonos speakers from your terminal

Modern Go CLI for Sonos speaker control over your local network (UPnP/SOAP).

Repo: https://github.com/steipete/sonoscli
Author: @steipete

Installation

brew install steipete/tap/sonoscli

Or build from source:

go install github.com/steipete/sonoscli/cmd/sonos@latest

Requirements

Machine must be on the same network as Sonos speakers
Speakers reachable on TCP port 1400
Spotify must be linked in Sonos app (for Spotify features)

Key Commands

Discovery & Status

sonos discover
sonos discover --format json
sonos status --name "Kitchen"
sonos now --name "Kitchen"

Playback

sonos play --name "Kitchen"
sonos pause --name "Kitchen"
sonos stop --name "Kitchen"
sonos next --name "Kitchen"
sonos prev --name "Kitchen"

Volume & Mute

sonos volume get --name "Kitchen"
sonos volume set --name "Kitchen" 25
sonos mute toggle --name "Kitchen"

Speaker Grouping

sonos group status
sonos group join --name "Bedroom" --to "Living Room"
sonos group unjoin --name "Bedroom"
sonos group solo --name "Office"
sonos group party --to "Bar"          # all speakers join target
sonos group dissolve --name "Living Room"

Queue Management

sonos queue list --name "Kitchen"
sonos queue play --name "Kitchen" 1    # play track at position
sonos queue remove --name "Kitchen" 3
sonos queue clear --name "Kitchen"

Favorites

sonos favorites list --name "Kitchen"
sonos favorites open --name "Kitchen" --index 1
sonos favorites open --name "Kitchen" "BBC Radio 6 Music"

Spotify

# Play a Spotify link
sonos open --name "Kitchen" https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG

# Enqueue a playlist
sonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M

# Search and play via SMAPI (no Spotify API credentials needed)
sonos play spotify --name "Office" "gareth emery"

# Search via Spotify Web API (needs SPOTIFY_CLIENT_ID/SECRET)
sonos search spotify --type track "daft punk harder better"
sonos search spotify --open --name "Kitchen" "miles davis so what"

Scenes (Presets)

sonos scene save "Evening"
sonos scene apply "Evening"
sonos scene list
sonos scene delete "Evening"

Play Arbitrary URI

sonos play-uri --name "Kitchen" "https://example.com/stream.mp3"
sonos tv --name "Living Room"       # switch to TV input
sonos linein --name "Kitchen" --from "Living Room"

Watch Live Events

sonos watch --name "Kitchen"
sonos watch --name "Kitchen" --format json

Output Modes

--format plain (default)
--format json
--format tsv
--debug for trace logs

Configuration

sonos config set defaultRoom "Office"
sonos config set format json
sonos config get

Room targeting supports fuzzy substring matching — --name "Kit" matches "Kitchen".

---name: sonos-cli-sonosclidescription: CLI to discover and control Sonos speakers over local network — playback, grouping, queue, favorites, scenes, Spotify, and volume. Use when an agent needs to control music playback, manage speaker groups, or play Spotify on Sonos.---# sonoscli — Control Sonos speakers from your terminalModern Go CLI for Sonos speaker control over your local network (UPnP/SOAP).- **Repo**: https://github.com/steipete/sonoscli- **Author**: [@steipete](https://github.com/steipete)## Installation```bashbrew install steipete/tap/sonoscli```Or build from source:```bashgo install github.com/steipete/sonoscli/cmd/sonos@latest```## Requirements- Machine must be on the same network as Sonos speakers- Speakers reachable on TCP port 1400- Spotify must be linked in Sonos app (for Spotify features)## Key Commands### Discovery & Status```bashsonos discoversonos discover --format jsonsonos status --name "Kitchen"sonos now --name "Kitchen"```### Playback```bashsonos play --name "Kitchen"sonos pause --name "Kitchen"sonos stop --name "Kitchen"sonos next --name "Kitchen"sonos prev --name "Kitchen"```### Volume & Mute```bashsonos volume get --name "Kitchen"sonos volume set --name "Kitchen" 25sonos mute toggle --name "Kitchen"```### Speaker Grouping```bashsonos group statussonos group join --name "Bedroom" --to "Living Room"sonos group unjoin --name "Bedroom"sonos group solo --name "Office"sonos group party --to "Bar" # all speakers join targetsonos group dissolve --name "Living Room"```### Queue Management```bashsonos queue list --name "Kitchen"sonos queue play --name "Kitchen" 1 # play track at positionsonos queue remove --name "Kitchen" 3sonos queue clear --name "Kitchen"```### Favorites```bashsonos favorites list --name "Kitchen"sonos favorites open --name "Kitchen" --index 1sonos favorites open --name "Kitchen" "BBC Radio 6 Music"```### Spotify```bash# Play a Spotify linksonos open --name "Kitchen" https://open.spotify.com/track/6NmXV4o6bmp704aPGyTVVG# Enqueue a playlistsonos enqueue --name "Kitchen" spotify:playlist:37i9dQZF1DXcBWIGoYBM5M# Search and play via SMAPI (no Spotify API credentials needed)sonos play spotify --name "Office" "gareth emery"# Search via Spotify Web API (needs SPOTIFY_CLIENT_ID/SECRET)sonos search spotify --type track "daft punk harder better"sonos search spotify --open --name "Kitchen" "miles davis so what"```### Scenes (Presets)```bashsonos scene save "Evening"sonos scene apply "Evening"sonos scene listsonos scene delete "Evening"```### Play Arbitrary URI```bashsonos play-uri --name "Kitchen" "https://example.com/stream.mp3"sonos tv --name "Living Room" # switch to TV inputsonos linein --name "Kitchen" --from "Living Room"```### Watch Live Events```bashsonos watch --name "Kitchen"sonos watch --name "Kitchen" --format json```## Output Modes- `--format plain` (default)- `--format json`- `--format tsv`- `--debug` for trace logs## Configuration```bashsonos config set defaultRoom "Office"sonos config set format jsonsonos config get```Room targeting supports fuzzy substring matching — `--name "Kit"` matches "Kitchen".

Frequently asked questions