Claude MarketplacesSubmit
jonnyblankinship avatar

Hue BLE MCP

jonnyblankinship/hue-ble-mcp

Lets you control Philips Hue lights over Bluetooth LE without needing a bridge or internet connection. Exposes seven tools: scanning for nearby lights, toggling power, adjusting brightness and color temperature, setting RGB colors via CIE 1931 XY conversion, reading current state, and applying preset scenes like relax or nightlight. Works by writing directly to Hue's GATT characteristics using bleak on macOS. Requires Bluetooth-enabled Hue bulbs and one-time pairing. Useful if you want Claude to adjust your desk lighting during focus sessions or set ambiance without cloud dependencies, though you're limited to Bluetooth range and macOS for now.

GitHub stars
1
tools
8
transport
STDIO
last updated
Mar 26, 2026
View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

scan_hue_lightsDiscover nearby Hue BLE lights and get their addresses

Discover nearby Hue BLE lights and get their addresses

No parameter schema in public metadata yet.

turn_onTurn a light on

Turn a light on

No parameter schema in public metadata yet.

turn_offTurn a light off

Turn a light off

No parameter schema in public metadata yet.

set_brightnessSet brightness 1–100%

Set brightness 1–100%

No parameter schema in public metadata yet.

set_color_temperatureSet white color temperature (2000K warm → 6500K cool)

Set white color temperature (2000K warm → 6500K cool)

No parameter schema in public metadata yet.

set_colorSet RGB color

Set RGB color

No parameter schema in public metadata yet.

get_light_stateRead current power, brightness, and color mode

Read current power, brightness, and color mode

No parameter schema in public metadata yet.

set_sceneApply a preset: relax, energize, concentrate, reading, nightlight, bright

Apply a preset: relax, energize, concentrate, reading, nightlight, bright

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

hue-ble-mcp

An MCP server that lets Claude control Philips Hue lights via Bluetooth LE — no Hue Bridge or internet connection required.

Just ask Claude things like:

  • "Turn off the light"
  • "Set the light to a warm reading mode"
  • "Make it a deep blue"
  • "Dim it to 20%"

Tools

ToolDescription
scan_hue_lightsDiscover nearby Hue BLE lights and get their addresses
turn_onTurn a light on
turn_offTurn a light off
set_brightnessSet brightness 1–100%
set_color_temperatureSet white color temperature (2000K warm → 6500K cool)
set_colorSet RGB color
get_light_stateRead current power, brightness, and color mode
set_sceneApply a preset: relax, energize, concentrate, reading, nightlight, bright

Requirements

  • macOS (uses CoreBluetooth via bleak)
  • Python 3.10+
  • A Philips Hue light with Bluetooth support (most lights made after 2019)
  • Claude Desktop

Installation

Option 1: pip (recommended)

pip install hue-ble-mcp

View the full README on GitHub

Details

Repository
github.com/jonnyblankinship/hue-ble-mcp
Package
hue-ble-mcp
Transport
STDIO
Registry
MCP registry, active