Which integrations are available for this server?

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.

How do I use Hue MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Hue MCP Server turn on the living room lights and set them to warm white" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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" } } } }