# Sonos agent skills for Claude Code, Cursor and RevampKey

> Ready-made Sonos playbooks for AI agents: set up your Sonos rooms for an evening with AI, route music across Sonos rooms with AI, find and play the right music on Sonos. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Sonos connector well and safely](https://revampkey.com/marketplace/sonos-mcp/skills/essentials.md): 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.
- [Set up your Sonos rooms for an evening with AI](https://revampkey.com/marketplace/sonos-mcp/skills/evening-listening-setup.md): 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.
- [Route music across Sonos rooms with AI](https://revampkey.com/marketplace/sonos-mcp/skills/multi-room-audio-routing.md): 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.
- [Find and play the right music on Sonos](https://revampkey.com/marketplace/sonos-mcp/skills/music-selection-from-library.md): Finds albums, playlists, stations and favourites from your registered music services, then confirms the choice before anything starts playing.
- [Balance volume and playback mix on Sonos with AI](https://revampkey.com/marketplace/sonos-mcp/skills/volume-and-mix-balancing.md): 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.

## Install

- RevampKey: connect Sonos at https://revampkey.com/marketplace/sonos-mcp; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
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
```

### 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.

MCP setup guide: https://revampkey.com/marketplace/sonos-mcp.md