Labsco
lsemenenko logo

OpenHue MCP Server

β˜… 10

from lsemenenko

Control Philips Hue lights using LLM interfaces via the OpenHue CLI.

πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeAdvanced setup

OpenHue MCP Server

An MCP server that enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.

Features

This server exposes the following capabilities through MCP:

Lights Control

  • List all lights or get specific light details
  • Turn lights on/off
  • Adjust brightness
  • Set colors
  • Control color temperature

Room Control

  • List all rooms or get room details
  • Control all lights in a room together
  • Set room-wide brightness and colors

Scene Management

  • List available scenes
  • Activate scenes with different modes
  • Filter scenes by room

Example Commands

Once connected, you can ask Claude natural language questions like:

  • "What lights do I have in the living room?"
  • "Turn on all the lights in the kitchen"
  • "Set the bedroom lights to 50% brightness"
  • "Change the office lights to blue"
  • "Activate the 'Relaxing' scene"
  • "What scenes are available in the den?"

Available Tools

get-lights

Lists all lights or gets details for specific lights

{
  lightId?: string;  // Optional light ID or name
  room?: string;     // Optional room name filter
}

control-light

Controls individual lights

{
  target: string;    // Light ID or name
  action: "on" | "off";
  brightness?: number; // 0-100
  color?: string;     // Color name
  temperature?: number; // 153-500 Mirek
}

get-rooms

Lists all rooms or gets specific room details

{
  roomId?: string;  // Optional room ID or name
}

control-room

Controls all lights in a room

{
  target: string;    // Room ID or name
  action: "on" | "off";
  brightness?: number;
  color?: string;
  temperature?: number;
}

get-scenes

Lists available scenes

{
  room?: string;    // Optional room name filter
}

activate-scene

Activates a specific scene

{
  name: string;     // Scene name or ID
  room?: string;    // Optional room name
  mode?: "active" | "dynamic" | "static";
}

Development

Project Structure

.
β”œβ”€β”€ src/
β”‚   └── index.ts    # Main server implementation
β”œβ”€β”€ build/          # Compiled JavaScript
β”œβ”€β”€ package.json
β”œβ”€β”€ tsconfig.json
└── README.md

Building

npm run build

Running

npm start