The Claw Light
Hardware overview, flashing firmware, and pairing the ESP32 LED with mccm.
The Claw Light is an ESP32-based LED that sits on your desk and glows the current mccm status color. mccm already supports driving an ESP32 status indicator, so the lamp is a drop-in display for the status you're already tracking.
What's inside
- An ESP32 microcontroller with onboard Wi-Fi
- An addressable RGB LED diffused behind the dome
- USB-C power
1. Flash the firmware
Connect the Claw Light over USB-C and flash the latest firmware. The firmware sources live alongside mccm in the repository.
If your unit shipped pre-flashed
Retail Claw Lights come with firmware already installed — you can skip straight to pairing.
2. Connect it to Wi-Fi
On first boot the light advertises a setup network. Join it, open the captive portal, and enter your Wi-Fi credentials. The light will reboot and connect.
3. Pair it with mccm
Point mccm at the light so it can push status updates:
mccm light add <light-ip-or-hostname>Then enable the integration:
mccm light enableThe lamp should immediately reflect your current aggregate status.
4. Test it
Trigger a state change — start a Claude Code session, or ask an agent something that requires your approval — and watch the light move through the status colors.
Configuration
Common options:
mccm light brightness <0-100>— set LED brightnessmccm light disable— temporarily turn the integration offmccm light remove <id>— unpair a light
Having trouble? See troubleshooting.