tebinraouf/hue-mcp

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

Available Tools

• change_hue_light - Control individual lights (brightness, hue, saturation, on/off)
• list_hue_lights - List all available lights on your Hue Bridge