# hue

> Control Philips Hue lights locally via the bridge HTTP API. Use for turning lights on/off, dimming, changing colors, and setting scenes. No cloud required.

- Author: Nikil Viswanathan
- Repository: nikilster/hue-skill
- Version: 20260124221539
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/nikilster/hue-skill
- Web: https://mule.run/skillshub/@@nikilster/hue-skill~hue:20260124221539

---

---
name: hue
description: Control Philips Hue lights locally via the bridge HTTP API. Use for turning lights on/off, dimming, changing colors, and setting scenes. No cloud required.
---

# Philips Hue

Control Philips Hue lights locally through the bridge's REST API.

## Requirements

- Philips Hue Bridge on local network
- Bridge username/API key (obtained through pairing)

## Setup

### 1. Find your bridge

```bash
{baseDir}/scripts/hue.sh discover
```

Or check https://discovery.meethue.com/

### 2. Pair with the bridge

```bash
{baseDir}/scripts/hue.sh pair <bridge_ip>
```

Press the button on your Hue bridge when prompted!

### 3. Save config

Config is saved to `~/.clawdbot/hue/config.json`

## Commands

```bash
# List all lights
{baseDir}/scripts/hue.sh lights

# List all rooms/groups
{baseDir}/scripts/hue.sh groups

# Control a light (by ID or name)
{baseDir}/scripts/hue.sh light <id> on
{baseDir}/scripts/hue.sh light <id> off
{baseDir}/scripts/hue.sh light <id> brightness 50    # 0-100

# Control a room/group
{baseDir}/scripts/hue.sh group <id> on
{baseDir}/scripts/hue.sh group <id> off
{baseDir}/scripts/hue.sh group <id> brightness 75

# Scenes
{baseDir}/scripts/hue.sh group <id> scene "night"    # warm red, dim
{baseDir}/scripts/hue.sh group <id> scene "normal"   # warm white
{baseDir}/scripts/hue.sh group <id> scene "bright"   # full daylight
```

## Scenes

Built-in scene presets:

| Scene | Description | Settings |
|-------|-------------|----------|
| night | Sleep-safe, no blue light | Warm red, 15% brightness |
| normal | Comfortable warm white | 2700K, 80% brightness |
| bright | Full daylight | 4000K, 100% brightness |
| red | Red | Hue 0, full saturation |
| blue | Blue | Hue 46920, full saturation |
| green | Green | Hue 25500, full saturation |

## Configuration

Config file: `~/.clawdbot/hue/config.json`

```json
{
  "bridge_ip": "192.168.1.100",
  "username": "your-api-key-here"
}
```

## Troubleshooting

**"Bridge not found"** — Check IP, ensure you're on the same network

**"Unauthorized"** — Re-run pairing: `hue.sh pair <ip>`

**"HTTPS blocked"** — Use HTTP (default). Hue bridges often have cert issues with HTTPS.