sonos-ts-mcp

Actively scan the network for Sonos devices using SSDP. Always call this when the sonos_list_devices tool returns empty or you are missing a device. Returns device UUID, IP address, room name, model, and firmware version. Use room name to communicate with the user.

Manually add a Sonos device by IP address. Use when SSDP discovery fails due to network restrictions or firewall rules. Device must be network-accessible on port 1400.

List devices currently in the registry. Note: Call sonos_discover first to populate the registry if a device is not found in the current registry. Returns UUID, IP address, room name, model, and software version of registered devices. Use room name to communicate with the user.

Start or resume playback on a Sonos device. Continues from current queue position and respects volume settings. If device is in a group, affects entire group.

Pause playback on a Sonos device. Maintains current position in track and queue for quick resume. If device is in a group, affects entire group.

Stop playback on a Sonos device. Clears playback state, unlike pause which maintains position.

Skip to next track in the queue.

Skip to previous track or restart current track if played more than a few seconds.

Get current transport state (playing, paused, stopped) and playback speed.

Get current track information, position, and duration. Includes track metadata like title, artist, album.

Retrieve the current playback queue with track information. Supports pagination for large queues.

Add a track URI to the playback queue. Supports music library URIs and streaming service URIs. Optional metadata in DIDL-Lite XML format.

Remove a track from the queue at the specified position.

Remove all tracks from the queue. Does not stop current playback.

Start playing from the queue at a specific position.

Save the current queue as a Sonos playlist with the specified title.

Enable or disable shuffle mode for queue playback.

Set repeat mode for queue playback. Options: off (no repeat), all (repeat entire queue), one (repeat current track).

Enable or disable crossfade between tracks. Crossfade creates smooth transitions between songs.

Get current playback settings including shuffle, repeat, crossfade, transport state, and speed.

Set volume level on a Sonos device. Range: 0 (silent) to 100 (maximum). Affects entire group if device is grouped.

Get current volume level from a Sonos device.

Mute or unmute a Sonos device. Mute preserves volume level for quick unmute.

Set bass EQ level. Range: -10 (reduced bass) to +10 (enhanced bass).

Set treble EQ level. Range: -10 (reduced treble) to +10 (enhanced treble).

Enable or disable loudness compensation. Loudness boosts bass and treble at low volumes for better sound quality.

Get current EQ settings including bass, treble, and loudness.

Set night mode for home theater devices. Reduces loud sounds and enhances quiet sounds for late-night viewing.

Set dialog enhancement for home theater devices. Enhances speech clarity in movies and TV shows.

Get zone group topology showing which devices are grouped together and their coordinator.

Join a device to another device's group for synchronized multi-room playback. The device will follow the master's playback.

Remove a device from its current group, making it a standalone player.

Join all discovered devices to the specified device to create a whole-house audio experience.

Browse artists in the music library. Supports pagination for large collections.

Browse albums in the music library. Supports pagination for large collections.

Browse all tracks in the music library. Supports pagination for large collections.

Browse music genres in the library. Supports pagination for large collections.

Browse Sonos playlists. Supports pagination for large collections.

Get favorite radio stations from Sonos favorites. Returns a list of saved radio stations with their metadata and streaming URIs.

Search the music library by artist, album, track, or genre. Returns matching items.

Browse a specific library item to get its children. For example, get albums for an artist or tracks for an album.

List all configured alarms including their schedule, enabled status, and room assignments.

Create a new alarm with specified time, days, music source, and settings. Returns the alarm ID.

Update an existing alarm. Only specified fields will be changed.

Delete an existing alarm permanently.

Set a sleep timer to automatically stop playback after the specified duration. Format: HH:MM:SS (e.g., "00:30:00" for 30 minutes).

Get remaining sleep timer duration. Returns empty if no timer is active.

Cancel the active sleep timer.

Take a snapshot of current device state including playback, volume, and EQ settings. Returns snapshot data for later restoration.

Restore a previously saved snapshot to return device to its captured state. Optionally fade in volume.

Subscribe to real-time events from a Sonos device service to receive automatic notifications of state changes.

Unsubscribe from a specific event subscription to stop receiving notifications.

Unsubscribe from all active event subscriptions for a specific device.

List all active event subscriptions for a device including subscription IDs and services.

List all available music services (Sonos Radio, TuneIn, Spotify, etc.) registered with the Sonos system. Returns service details including name, ID, and authentication type. IMPORTANT: Most services require authentication (authType: DeviceLink or AppLink) and will not work unless the user has linked…

Browse content from a music service. WARNING: Most services (especially Sonos Radio, Spotify, Apple Music) require authentication and will return empty results or errors if not authenticated. Check authType from sonos_list_music_services first. Only "Anonymous" services (like SomaFM Radio) are guara…

Search for content within a music service. WARNING: Requires authentication for most services. Will return errors if the service requires DeviceLink or AppLink authentication and the user has not linked their account in the Sonos app. Prefer sonos_get_favorite_radio_stations for radio content.

Play a specific item from a music service such as a radio station, track, album, or playlist. Use the item ID from browse or search results.

Get the playable streaming URI for a specific music service item. This is useful for debugging or inspecting the actual stream URL.

An AI-powered assistant that can take natural language instructions and autonomously control the Sonos system. Use this when you need to solve complex multi-step tasks or when you're unsure which specific tools to use. The agent can discover devices, control playback, manage groups, browse music, an…