Provides tools for controlling Philips Hue smart lights, including turning lights on/off, adjusting brightness, hue, and saturation, and listing all available lights on a Hue Bridge.
Hue MCP Server
Control Philips Hue lights through VS Code Copilot or Claude Desktop using the Model Context Protocol (MCP).
Quick Setup
1. Prerequisites
Python 3.13+ with UV package manager
Hue Bridge IP address (find it in the Hue app or at https://discovery.meethue.com/)
2. Install Dependencies
3. Configure Your Bridge IP
Edit .env
file:
4. First-Time Authentication
Press the physical button on your Hue Bridge, then run:
Usage
For VS Code Copilot
Add to your VS Code MCP configuration file (mcp.json
):
Location: ~/Library/Application Support/Code/User/mcp.json
(macOS)
Note: Replace the paths with your actual project path and update HUE_BRIDGE_IP
with your bridge IP.
After adding the configuration, reload VS Code and use Copilot:
"Turn on the corner light and set it to blue"
"List all my lights"
"Turn off all lights"
For Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
:
Available Tools
change_hue_light
- Control individual lights (brightness, hue, saturation, on/off)list_hue_lights
- List all available lights on your Hue Bridge
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables control of Philips Hue lights through VS Code Copilot or Claude Desktop using natural language commands. Supports turning lights on/off, adjusting brightness, changing colors, and listing available lights on your Hue Bridge.