get-lightsLABSCO SUMMARY
Rooms and scenes, not just bulbs.
Controlling a single light is rarely the request. Because rooms and scenes are first-class here, dim the kitchen and put the evening scene on are single calls rather than a loop over bulb ids.
What it is
A Node MCP server that drives Philips Hue through the OpenHue CLI running in Docker. It lists and controls individual lights, whole rooms and scenes against your own Hue Bridge.
What you get
- All lights listed, or details for one
- A light turned on or off, dimmed, coloured, or set to a colour temperature
- Rooms listed, and every light in a room controlled together
- Scenes listed, and filtered by room
- A scene activated, in the mode you choose
Requirements
Node.js v16 or higher and Docker, plus a one-time OpenHue CLI setup that pairs with your bridge — you press the link button on the bridge during that step. The pairing lives in ~/.openhue afterwards.
Setup effort
Follow the published steps — docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
USE CASES
01
Setting the mood without hunting through the app
List the scenes for the room and activate the one you mean.
02
Dimming a whole room at once
Address the room rather than each bulb, and set brightness across it.
03
Fixing the one lamp that is wrong
Find the light by name and set it back — on, off, brightness or colour.
04
Finding out what is actually on
List the lights and rooms and read their state, before turning anything off remotely.
05
Changing colour temperature for the time of day
Warm a light or a whole room without opening the colour picker.
6 tools
Listed in project docs. Your client may show a different list.
control-lightget-roomscontrol-roomget-scenesactivate-sceneBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Requires
- Node.js v16 or higher
- Docker, for the OpenHue CLI
- A Philips Hue Bridge on your network
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
Pair the OpenHue CLI with your Hue Bridge (one time). Press the link button on the bridge when the CLI asks. On Windows PowerShell, the folder is ${env:USERPROFILE}\.openhue rather than ${HOME}/.openhue:
TERMINAL
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
git clone https://github.com/lsemenenko/openhue-mcp-server
cd openhue-mcp-server
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"hue": {
"command": "node",
"args": [
"<YOUR_PATH_TO_BUILD>/index.js"
]
}
}
}<YOUR_PATH_TO_BUILD> is the build folder inside your openhue-mcp-server clone, written as a full path. Restart Claude Desktop afterwards.
