SMART HOME / HM-SH-039
HM-SH-039 · datasheet

sonos-ts-mcp

Sonos MCP server in TypeScript

01 · What it does

  • AI-Powered Agent Tool: Natural language control via the sonos_agent tool (requires AI API keys) ✨ NEW
  • Topology Persistence: Device topology automatically saved to disk and loaded on startup
  • Intelligent Device Resolution: Control devices by friendly name (e.g., "Kitchen") instead of UUIDs
  • Automatic Discovery: Discovers devices on startup and every 5 minutes
  • Device Discovery: Manual SSDP-based discovery of Sonos devices

02 · Install

$ npm install
$ npm run build

03 · Client config (Claude Desktop / Cursor, from README)

{
  "mcpServers": {
    "sonos-ts-mcp": {
      "command": "npx",
      "args": ["-y", "sonos-ts-mcp@latest"]
    }
  }
}

Commands copied from the project README. Placeholders are the maintainer's. Not bench-tested by HardwareMCP yet.

Weekly bulletin

New hardware MCP servers and setups that actually worked on a bench. One email, Fridays.