Hue MCP 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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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 sync3. Configure Your Bridge IP
Edit .env file:
HUE_BRIDGE_IP=192.168.1.XXX # Replace with your bridge IP4. 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')"Related MCP server: Philips Hue MCP Server
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"
}
}
}
}Available Tools
change_hue_light- Control individual lights (brightness, hue, saturation, on/off)list_hue_lights- List all available lights on your Hue Bridge
Available Tools
2 toolschange_hue_lightA
Change the state of a Philips Hue light.
Args: light_id: The ID of the light to control (1-based index) brightness: Brightness level (0-254), where 0 is minimum and 254 is maximum hue: Hue color value (0-65535), where 0 and 65535 are red, 25500 is green, and 46920 is blue saturation: Color saturation (0-254), where 0 is white and 254 is most saturated on: Turn the light on (True) or off (False)
Returns: A message indicating the result of the operation
Inputs: light_id (required), brightness, hue, saturation, +1 more. Returns: result
list_hue_lightsA
List all available Philips Hue lights.
Returns: A formatted list of all lights with their IDs, names, and current states
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes with no overlap: one lists lights (read-only) while the other controls light states (write operation). An agent would never confuse these tools as they operate on different aspects of the Hue system.
Both tools follow a consistent verb_noun pattern with 'hue_light(s)' as the common noun component. 'list_hue_lights' and 'change_hue_light' maintain perfect naming consistency throughout the toolset.
With only 2 tools, this server feels severely underpowered for controlling a Philips Hue lighting system. A proper Hue interface would need tools for scenes, groups, schedules, bridge configuration, and more comprehensive light management beyond just listing and changing individual lights.
The tool surface is severely incomplete for Hue light control. Missing essential operations include: creating/deleting lights, managing scenes or groups, adjusting transition times, setting color temperatures, configuring bridge settings, and error handling for unavailable lights. Agents will hit dead ends trying to perform basic Hue workflows.
Maintenance
Related MCP Connectors
Share context and questions between Claude instances — VS Code, claude.ai web, and mobile.
Control your existing Philips lights, Sonos speakers, Roborock vacuums and other supported devices through Port OS cloud. Give ChatGPT, Claude and other MCP-compatible assistants access to the devices you connect. Turn off the living room lights, play music on your speakers, adjust the thermostat, run a vacuum in a room, check a camera snapshot or find a connected tracker. Available actions depend on your linked provider accounts and each device’s supported capabilities. Port OS runs in the cloud; no local server is required. You choose the account, device and capability permissions each assistant receives. Device operations require user OAuth; public tool discovery does not grant device access. Port OS is in alpha. Setup: https://portoperatingsystem.com/docs/getting-started/ Support: https://portoperatingsystem.com/contact/
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.610MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Philips Hue smart lighting systems, including individual lights, groups, scenes, brightness, and color adjustments through natural language commands.-
- AlicenseNot gradedqualityDmaintenanceControls Philips Hue lights based on Claude Code session events, using color animations to indicate Claude's status (thinking, working, success, etc.).12 npm10Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to control Philips Hue smart lighting systems using natural language, supporting light control, group management, scenes, and presets.MIT