Sonos agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Sonos work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Sonos

Connect Sonos once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Sonos skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing18 Sonos tools

Use the Sonos connector well and safely

Teaches an AI assistant how to confirm the household and room before playing, pausing, grouping or changing volume on Sonos, and asks for your approval before each change.

Use it when

You want to play music in one room without disturbing the others
You want to check what is playing before the assistant changes anything
A Sonos command failed or did nothing and you need to know why

Tools it uses

get_households_and_groups_and_players
get_now_playing
play_track
play_album
play_artist
play_playlist
play_sonos_playlist
play_sonos_favorite
play_station
play_radio
pause
adjust_player_volume
adjust_group_volume
play_player_line_in
add_players_to_group
remove_players_from_group
move_audio_to_players
get_night_sound_and_speech_enhancement

Example

Play the jazz playlist in the kitchen, but leave the living room alone.

Your household has two groups: Kitchen, and Living Room with Hall. I checked the kitchen and it is idle. Here is the change I would make: play your Jazz Evening playlist in the Kitchen only. The living room is not affected. Do you want me to start it?

Use in RevampKeyRead the full skill →

Asks before writing9 Sonos tools

Set up your Sonos rooms for an evening with AI

Prepares a Sonos room or group for dinner, a party or a quiet night: picks the right players, groups or separates them, balances volume, and applies night sound and speech settings if you ask. It confirms each change with you before making it.

Use it when

Hosting people over and want the kitchen and living room sounding together
A quiet night in with the bedroom kept separate and the TV clearer
Getting the house ready for a party without waking the rooms that should stay quiet

Tools it uses

get_households_and_groups_and_players
get_now_playing
get_group_volume
get_player_volume
get_night_sound_and_speech_enhancement
add_players_to_group
remove_players_from_group
adjust_player_volume
adjust_group_volume

Example

We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.

Your household has four rooms. I'd group the kitchen and dining room, leave the bedroom separate, and set the dining room to a conversation level and the kitchen a little lower. Want me to make those changes?

Use in RevampKeyRead the full skill →

Asks before writing7 Sonos tools

Route music across Sonos rooms with AI

Moves, adds or removes rooms from a Sonos group and checks the result, so the music keeps playing where you want it. Asks before changing any grouping.

Use it when

Adding a room to what is already playing
Moving the music from the kitchen to the patio
A room has dropped out of the group and needs to be brought back

Tools it uses

get_households_and_groups_and_players
get_now_playing
get_player_volume
get_group_volume
add_players_to_group
remove_players_from_group
move_audio_to_players

Example

Add the bathroom to the living room group without stopping the music.

The living room group is playing. I've added the bathroom to it, and it now plays the same audio. Before I make the change I'll confirm you want to add it to that group.

Use in RevampKeyRead the full skill →

Read-only13 Sonos tools

Find and play the right music on Sonos

Finds albums, playlists, stations and favourites from your registered music services, then confirms the choice before anything starts playing.

Use it when

You want a specific album, playlist or station played in a room.
You want something from your saved Sonos favourites.
You are not sure which music service has what you want.

Tools it uses

get_registered_music_services
get_sonos_favorites
get_sonos_playlists
play_album
play_artist
play_track
play_radio
play_station
play_sonos_favorite
play_sonos_playlist
play_playlist
play_player_line_in
get_now_playing

Example

Play my Sunday jazz playlist in the kitchen.

I found 'Sunday Jazz' in your Sonos playlists. I'll play it on Spotify in the Kitchen. Shall I go ahead?

Use in RevampKeyRead the full skill →

Read-only7 Sonos tools

Balance volume and playback mix on Sonos with AI

Reads the current volume of each Sonos room and group, then proposes small relative adjustments so one room stops overpowering the rest. It lists every change and waits for your yes before touching the speakers.

Use it when

One room is much louder or quieter than the others
You want the kitchen quieter without changing the living room
You want shuffle, repeat or crossfade set for background listening

Tools it uses

get_households_and_groups_and_players
get_player_volume
get_group_volume
get_now_playing
get_shuffle_repeat_crossfade
adjust_player_volume
adjust_group_volume

Example

The kitchen is way louder than the living room. Can you balance them?

Kitchen is at 40 and Living room at 25, with both playing the same album. Proposed: lower Kitchen from 40 to 30 and leave Living room untouched. Awaiting your explicit yes before I change anything.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Sonos, updates them for you and removes them when you disconnect.

Download RevampKey

How Sonos skills work

Connect Sonos
The Sonos MCP server gives the agent its tools.
Ask in plain words
“We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Sonos skills

In RevampKey the skills install themselves when you connect Sonos. In other tools each skill is one folder with a SKILL.md file, and you also need the Sonos MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Sonos. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.”
Download RevampKeyConnect Sonos · 1 click
Get RevampKey to connect Sonos
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Sonos is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials evening-listening-setup multi-room-audio-routing music-selection-from-library volume-and-mix-balancing; do curl -fsSL --create-dirs -o .claude/skills/sonos-mcp-$s/SKILL.md https://revampkey.com/marketplace/sonos-mcp/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Sonos MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials evening-listening-setup multi-room-audio-routing music-selection-from-library volume-and-mix-balancing; do
  curl -fsSL --create-dirs -o .claude/skills/sonos-mcp-$s/SKILL.md https://revampkey.com/marketplace/sonos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.”

Into the shared .agents/skills folder

Connect the Sonos MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials evening-listening-setup multi-room-audio-routing music-selection-from-library volume-and-mix-balancing; do
  curl -fsSL --create-dirs -o .agents/skills/sonos-mcp-$s/SKILL.md https://revampkey.com/marketplace/sonos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.”

Into the shared .agents/skills folder

Connect the Sonos MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials evening-listening-setup multi-room-audio-routing music-selection-from-library volume-and-mix-balancing; do
  curl -fsSL --create-dirs -o .agents/skills/sonos-mcp-$s/SKILL.md https://revampkey.com/marketplace/sonos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.”

Into the shared .agents/skills folder

Connect the Sonos MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials evening-listening-setup multi-room-audio-routing music-selection-from-library volume-and-mix-balancing; do
  curl -fsSL --create-dirs -o .agents/skills/sonos-mcp-$s/SKILL.md https://revampkey.com/marketplace/sonos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “We're having six people for dinner. Put the kitchen and dining room together, keep the bedroom out of it, and set it to a conversation level.”

RevampKey or copy the files?

In RevampKey

One click when you connect Sonos
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Sonos MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Sonos skills FAQ

What is a Sonos agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Sonos skill describes one job, which Sonos tools to use in which order, what to check first and when to stop and ask you.

Do the Sonos skills change anything on their own?

2 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Sonos.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Sonos; elsewhere you copy the folders into your project or skills directory.

Do I need the Sonos MCP server too?

Yes. The skills tell the agent how to do the work; the Sonos MCP server gives it the tools to do it. The Sonos MCP setup guide covers every client.

Sonos MCP server setup · This page as Markdown

Put Sonos’s best workflows in your agent

Download RevampKey, connect Sonos and ask your first question in about a minute.

Download RevampKey Connect Sonos · 1 click

All 5 Sonos skills

Use the Sonos connector well and safely

Use it when

Tools it uses

Set up your Sonos rooms for an evening with AI

Use it when

Tools it uses

Route music across Sonos rooms with AI

Use it when

Tools it uses

Find and play the right music on Sonos

Use it when

Tools it uses

Balance volume and playback mix on Sonos with AI

Use it when

Tools it uses

Get all 5 without copying a file

How Sonos skills work

How to install Sonos skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Sonos skills FAQ

Put Sonos’s best workflows in your agent

Skills for related tools