Canonical: https://mintisdynamics.com/connectors/elgato-key-light

# Elgato Key Light

The Elgato Key Light or Key Light Air on the home network: switch it on or off, set how bright it is, make the light warmer or cooler, and hear how it is set. The host finds each light by itself and speaks to it directly; the registry never reaches it. Elgato does not document this interface; it is the one its own Control Center app uses.

- Verified: yes (https://docs-dev.mintisdynamics.com/get-started/verified)
- Published by: Mintis
- Provider: elgato
- Kind: IoT
- Published: 2026-11-09
- Last reviewed: 2026-11-09
- How it runs: Runs through the service’s API. 4 of 5 actions ask first, confirmed with the same signal or a word.
- Your data: Light commands go from your host to the light on your home network. Nothing passes through the registry.

## Actions (5)

### Light on

Switch the light on, at the brightness it had.

- Action: `turn-on`
- Tier: asks first
- Presets:
  - {light} on

Parameters:

- `light` · Light · string · required
- `number_of_lights` · Number of lights · integer · required
- `on` · Power · integer · required

### Light off

Switch the light off.

- Action: `turn-off`
- Tier: asks first
- Presets:
  - {light} off

Parameters:

- `light` · Light · string · required
- `number_of_lights` · Number of lights · integer · required
- `on` · Power · integer · required

### Brightness

Set how bright the light is, in percent.

- Action: `brightness`
- Tier: asks first
- Presets:
  - {light} to 10 percent
  - {light} to 25 percent
  - {light} to 50 percent
  - {light} to 75 percent
  - {light} to 100 percent

Parameters:

- `light` · Light · string · required
- `number_of_lights` · Number of lights · integer · required
- `brightness` · Brightness · integer · required Options: 10 percent (10), 25 percent (25), 50 percent (50), 75 percent (75), 100 percent (100).

### Warmth

Make the light warmer or cooler.

- Action: `temperature`
- Tier: asks first
- Presets:
  - {light} warm
  - {light} soft white
  - {light} neutral
  - {light} cool

Parameters:

- `light` · Light · string · required
- `number_of_lights` · Number of lights · integer · required
- `temperature` · Warmth · integer · required Options: Warm (344), Soft white (280), Neutral (213), Cool (143).

### How it is set

Say whether the light is on and how bright it is.

- Action: `status`
- Tier: only reads
- Presets:
  - How is {light} set

Parameters:

- `light` · Light · string · required
