Sonos MCP Server (cmd/mcp-sonos) is a standalone Model Context Protocol server built in Go within the homectl ecosystem. It connects autonomous AI agents to physical whole-home audio systems over local UPnP, solving the real-world protocol traps of coordinator routing, cloud containers, and acoustic volume safety.
Key Features
- 12 Typed MCP Tools: Comprehensive transport control, volume stepping, cloud favorite playback, queue reordering, and service discovery.
- Automated Coordinator Resolution: Transparently detects follower speakers in stereo pairs or grouped zones and routes mutations exclusively to the master coordinator.
- Zero-Token Cloud Favorites: Plays Spotify, Apple Music, and YouTube Music playlists via Sonos Favorites (
FV:2) without requiring external API keys. - Acoustic Safety Clamps: Enforces volume boundaries with a 15–40% default listening range, confirmation gates above 60%, and an emergency cap at 80%.
- Jibo Social Robot Integration: Powers conversational audio and embodied rhythmic dance performances on the restored Jibo social robot via Project Apeye (
apeye.net).
Explore the source code on GitHub: github.com/ghchinoy/homectl.