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

uv sync

3. Configure Your Bridge IP

Edit .env file:

HUE_BRIDGE_IP=192.168.1.XXX # Replace with your bridge IP

4. First-Time Authentication

Press the physical button on your Hue Bridge, then run:

uv run python -c "from phue import Bridge; Bridge('YOUR_BRIDGE_IP')"

Usage

For VS Code Copilot

Add to your VS Code MCP configuration file (mcp.json):

Location: ~/Library/Application Support/Code/User/mcp.json (macOS)

{ "mcpServers": { "custom-hue": { "type": "stdio", "command": "uv", "args": [ "run", "--directory", "__PATH__", "python", "__PATH_TO_main.py__" ], "env": { "HUE_BRIDGE_IP": "192.168.x.x" } } } }

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:

{ "mcpServers": { "hue-lights": { "command": "uv", "args": ["run", "/FULL/PATH/TO/custom-hue/main.py"], "env": { "HUE_BRIDGE_IP": "192.168.1.XXX" } } } }