Philips Hue

You can manage Philips Hue smart lights through a dedicated MCP (Model Context Protocol) server. This server lets you list lights, groups, and scenes, adjust brightness and color settings, and activate scenes from compatible clients. It’s designed for easy integration with AI assistants and automated workflows while keeping your Hue Bridge securely reachable on your local network.

How to use

You connect an MCP client to the Hue MCP server to control your lights. Start by ensuring the Hue Bridge is reachable on your network and that you have a valid API key (username) for the bridge. With the server running, you can ask your client to list all lights, turn lights on or off, adjust brightness, change color temperature or color, manage groups, and activate predefined scenes. Use natural language or scripted prompts to perform common tasks like turning on the living room lights, setting a kitchen light to a warm white color, or activating a specific scene.

How to install

Prerequisites: Python 3.10 or higher, a Philips Hue Bridge on your network, and an API key for the Hue Bridge.

1. Prepare the environment and dependencies.

Create a Python virtual environment and install the MCP package in editable mode. Choose one of the following options.

Available tools

list_lights

List all lights with their current state (on/off, brightness, color, etc.)

get_light_state

Retrieve detailed state information for a specific light

turn_light_on

Turn a light on and optionally set brightness

turn_light_off

Turn a light off

set_brightness

Adjust brightness level (0-254) for a light

set_color_temp

Set color temperature in mireds (153-500) for a light

set_color

Set color using CIE xy coordinates for a light

list_groups

List all light groups or rooms

control_group

Control all lights within a specified group

list_scenes

List all available scenes for quick activation

activate_scene

Activate a predefined scene on the selected lights