set_volume
Adjust the volume of your active Spotify device using a percentage range (0-100). Enables hands-free control, dynamic adjustments, and smart home automation for personalized 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) |