mcpField
S
sonos

sonos

github.com/steipeteOther7.4k75 installsUpdated 1w ago
Repository

About sonos

A skill for carrying out Sonos music and playback workflows with existing local tooling. It covers playback, queues, rooms, groups, and YouTube sources while requiring confirmation before changing playback state.

Key features

  1. 01Search and play music
  2. 02Manage playback queues
  3. 03Control playback and volume
  4. 04Group or move rooms
  5. 05Handle YouTube audio sources

Use cases

  1. 01Play a requested track or album
  2. 02Pause or adjust room playback
  3. 03Play supported YouTube audio
  4. 04Move playback between rooms

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steipete/agent-scripts --skill sonos

After installing, type/sonosin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

Sonos

Use for Sonos music, playback, queue, room/group, and YouTube workflows.

Rules

  • Prefer existing local Sonos tooling in the current repo before inventing shell/API calls.
  • Do not change speaker groups, queues, or playback unless the user asks for it.
  • Confirm target room/group when ambiguous.
  • For YouTube, prefer a playable audio URL or local extraction workflow already present in the repo; avoid downloading unless requested.
  • Keep network/debug work out of scope unless the user explicitly asks for diagnostics.
  • Secrets, service tokens, and account auth: check env/profile first; use op only via the repo/AGENTS rules.

Workflow

  1. Discover repo commands:
    • rg --files
    • package scripts or CLI help
  2. Identify target:
    • room/group
    • service/source
    • query, URL, playlist, album, artist, or track
  3. Dry-read current state when useful:
    • rooms/groups
    • now playing
    • queue
  4. Execute the requested playback action.
  5. Verify by reading current state again.

Common Tasks

  • Search and play music by track, album, artist, playlist, or station.
  • Add or replace the queue.
  • Pause, resume, skip, seek, shuffle, repeat.
  • Set volume or mute for a room/group.
  • Move/group playback between rooms.
  • Play YouTube audio/music through Sonos when supported by local tooling.

YouTube Notes

  • Treat YouTube URLs as media sources first, not as download requests.
  • If conversion/extraction is needed, prefer the local toolchain already used by the repo.
  • State constraints clearly when Sonos/service support blocks direct playback.

Comments

Markdown supported