io.github.jonnyblankinship/hue-ble-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HUE_LIGHT_ADDRESS | No | Default Bluetooth address (UUID) of a Hue light to avoid specifying in every command. Optional; can be left empty. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| scan_hue_lightsA | Scan for Philips Hue BLE lights nearby and return their names and addresses. Run this first to find your light's Bluetooth address — you'll need it for all other tools. On macOS, addresses look like UUIDs (e.g. 'BEF1AF5D-9A4D-4C2B-8870-1AB7CC5CE8DD'). This is normal — macOS CoreBluetooth uses its own identifiers instead of MAC addresses. Args: timeout: How many seconds to scan (default 10). Increase if your light isn't found. |
| turn_onB | Turn on a Philips Hue light. Args: address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| turn_offA | Turn off a Philips Hue light. Args: address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| set_brightnessA | Set the brightness of a Philips Hue light (turns it on if off). Args: brightness: Brightness as a percentage, 1–100. address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| set_color_temperatureA | Set the color temperature of a Philips Hue light. Switches the light to white/CT mode (disables any color). Args: kelvin: Color temperature in Kelvin. 2000K = very warm candlelight 2700K = warm white (typical bulb) 4000K = neutral / office white 6500K = cool daylight address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| set_colorA | Set the color of a Philips Hue light using RGB values. Switches the light to color mode. Use set_color_temperature to go back to white mode. Args: red: Red channel, 0–255 green: Green channel, 0–255 blue: Blue channel, 0–255 address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| get_light_stateA | Read the current state of a Philips Hue light (power, brightness, color mode). Args: address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| set_sceneA | Apply a preset lighting scene to a Philips Hue light. Available scenes: relax - Dim warm amber, great for winding down energize - Bright cool white, boost alertness concentrate - Bright neutral white, focus mode reading - Warm white at comfortable reading level nightlight - Very dim warm red, minimal sleep disruption bright - Full brightness daylight white Args: scene: Scene name (case-insensitive) address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool has a distinct, non-overlapping purpose: scanning, state reading, toggling power, setting brightness, color, color temperature, and scenes. No ambiguity in tool selection.
All tools follow a consistent verb_noun pattern in snake_case (e.g., scan_hue_lights, set_brightness, turn_off). No mixing of conventions.
8 tools is well-scoped for controlling a single Hue light via BLE. Each function is necessary and none feel extraneous.
Covers all core operations: discovery, state reading, on/off, brightness, color, color temperature, and preset scenes. No obvious gaps for single-light control.