Sonos MCP Server

MCP server for CastBreeze functionality - control Sonos speakers and play audio streams

Local serverstdio

What is the Sonos MCP Server?

MCP server for CastBreeze functionality - control Sonos speakers and play audio streams

The short version

Model Context Protocol (MCP) server for controlling Sonos speakers and playing audio streams through CastBreeze.

  • 🔐 OAuth authentication with CastBreeze
  • 🔊 Control Sonos speakers through MCP
  • 🎵 Play audio clips (MP3, WAV) from URLs or local files
  • 📻 Stream audio URLs on repeat
  • 🎚️ Manage playback priority and volume
  • 🏠 Get speaker groups and player information

What it needs from you

  • Node.js >= 22.0.0 - CastBreeze account (for OAuth authentication) - Sonos speakers on your network

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
start_loginStart OAuth login flow (opens browser)
finish_loginComplete OAuth login with authorization code
play_default_chimePlay the default chime sound
Parametersuri, groups (optional), volume (optional)
play_audio_clipPlay an audio clip (MP3/WAV)
Supportshttps://, http://, file:// URIs
play_radioPlay a URI on repeat (streaming)
get_groupsGet all speaker groups and players

How to install the Sonos MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js >= 22.0.0 - CastBreeze account (for OAuth authentication) - Sonos speakers on your network

Example prompts to try

  • “Use Sonos to PNPM.”
  • “Use Sonos to Authentication.”
  • “Use Sonos to Playback.”

Frequently asked questions

MCP server for CastBreeze functionality - control Sonos speakers and play audio streams Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.