Sonos Mcp

Name: Sonos Mcp
Author: castbreeze

@castbreeze

Repository

About Sonos Mcp

MCP server for controlling Sonos speakers and playing audio streams.

#sonos #castbreeze #audio #streaming

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Start OAuth login flow. Opens browser for user to authorize. IMPORTANT: After calling this tool, you MUST wait for the user to complete authorization in their browser. The user will provide you with an authorization code, which you must then use with the finish_login tool.

Complete OAuth login by exchanging authorization code for access tokens. IMPORTANT: Only call this tool after the user has completed authorization in their browser and provided you with the authorization code from the callback page.

Get all speaker groups and players. Requires authentication.

Play default chime sound. Requires authentication.

Play an audio clip on a Sonos player using the extended audioClip endpoint. Supports MP3 and WAV files from a URL or local file path. The file parameter accepts both URLs and local file paths. Requires authentication.

Plays a URI on repeat. Requires authentication.

Overview

What is Sonos Mcp?

MCP server for controlling Sonos speakers and playing audio streams. It integrates with the Sonos ecosystem via the Model Context Protocol, enabling MCP clients to interact with Sonos devices.