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. |
Capabilities
Features and capabilities supported by this server
| 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_lights | 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_on | Turn on a Philips Hue light. Args: address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| turn_off | Turn off a Philips Hue light. Args: address: Bluetooth address from scan_hue_lights. Leave blank to use HUE_LIGHT_ADDRESS env var. |
| set_brightness | 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_temperature | 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_color | 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_state | 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_scene | 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jonnyblankinship/hue-ble-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server