Set a Roon zone's volume to a target percent
set_volumeSet the volume to a specific level in a Roon zone. Enter a percentage from 0 (silent) to 100 (max) for precise control.
Instructions
Use this when the user wants to change how loud a zone is — turn it up, turn it down, set the volume, or pick a level for a specific room (e.g. "turn it up to 60", "volume to 30 in the office", "set the kitchen to 50", "louder" — see note). Sets the zone's volume to level percent (0 = silent, 100 = max). The server rescales to each output's native range, so a single value works across mixed devices in a grouped zone. Incremental outputs (IR blasters with no numeric range) are reported as skipped rather than guessed at. zoneId is optional and resolves like now_playing. NOTE on relative changes ("louder" / "softer" without a number): this tool is absolute — read the current state with now_playing isn't enough on its own (volume isn't exposed there), so for relative changes, ask the user for a target percent or apply a reasonable default delta.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zoneId | No | Target zone id or output id from list_zones. Omit to use ROON_DEFAULT_ZONE or fall back automatically. | |
| level | Yes | Target volume in percent (0 = silent, 100 = max). Mapped to each output's native range. |