set_volume
Adjust Spotify playback volume on active devices using a percentage scale (0-100). Enables dynamic volume changes, smart home integration, and hands-free control for custom audio experiences.
Instructions
Adjust the volume level for the user's active Spotify device.
šÆ USE CASES: ā¢ Create dynamic volume adjustments for different times of day ā¢ Build smart home automation with volume control ā¢ Implement voice commands for hands-free volume changes ā¢ Adjust volume based on ambient noise levels ā¢ Create custom audio experience controls
š WHAT IT RETURNS: ā¢ Confirmation of successful volume change ā¢ Current volume level after adjustment ā¢ Device information showing updated state ā¢ Previous volume level for potential undo functionality ā¢ Playback state with new volume settings
š EXAMPLES: ā¢ "Set volume to 50%" ā¢ "Lower the volume to 25" ā¢ "Turn up the music to 80%" ā¢ "Make it quieter, set to 15%"
š VOLUME CONTROL: ā¢ Range: 0-100 percent ā¢ 0 = Complete silence (muted) ā¢ 100 = Maximum device volume ā¢ Changes apply instantly during playback ā¢ Preserves volume setting for future sessions
ā ļø REQUIREMENTS: ā¢ Valid Spotify access token with user-modify-playback-state scope ā¢ Active device that supports volume control ā¢ Device must be currently available and responsive
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deviceId | No | Spotify device ID (optional, uses active device if not specified) | |
| token | Yes | Spotify access token for authentication | |
| volume_percent | Yes | Volume level as a percentage (0-100) |