Control a light
hive_set_lightSwitch a Hive light on or off and set its brightness, white colour temperature, or colour using hue and saturation for tuneable and colour bulbs.
Instructions
Switch a Hive light on or off, and set its brightness, its white colour temperature (tuneable and colour bulbs) or its colour as hue and saturation (colour bulbs).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hive_set_light"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| on | No | true to switch on, false to switch off. Setting a brightness, colour temperature or colour also switches the light on | |
| hue | No | Colour, for colour bulbs: hue in degrees, 0 to 359 (0 red, 120 green, 240 blue). Switches the bulb to colour mode; the saturation is kept unless given | |
| light | No | Light, by name or ID (see hive_list_smart_devices). Can be left out when there's only one | |
| dry_run | No | Preview only: check the call and return the exact requests it would send to Hive, without sending them. Nothing is changed | |
| brightness | No | Brightness in percent, 5 to 100 (rounded to the nearest 5, as the Hive app does). With hue or saturation, the colour's brightness | |
| saturation | No | Colour, for colour bulbs: saturation in percent, 0 (white) to 100 (full colour). Switches the bulb to colour mode; the hue is kept unless given | |
| colour_temperature | No | White colour temperature in kelvin, for tuneable and colour bulbs: about 2700 (warm) to 6500 (cool) |