Philips Hue

Controls Philips Hue lights via MCP by listing lights, setting brightness and color, and toggling lights through MCP clients.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "m2ai-mcp-servers-mcp-philips-hue": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-philips-hue"
      ],
      "env": {
        "HUE_API_KEY": "your-api-key-here",
        "HUE_BRIDGE_IP": "192.168.1.x"
      }
    }
  }
}

You can control Philips Hue smart lights through a dedicated MCP server, enabling you to list lights, adjust brightness, set colors, and toggle lights from any MCP client. This server bridges your Hue Bridge and your automation workflows, giving you reliable, programmatic access to your lighting setup.

How to use

You will connect with an MCP client to interact with your Hue lights. Use the available actions to discover lights, change brightness, switch colors, and turn lights on or off. Each command targets a specific light or all lights, allowing you to manage lighting across rooms or scenes from your automation scripts.

How to install

Prerequisites you need before installing this MCP server are Node.js version 18 or newer, a Philips Hue Bridge on your local network, and a Hue API key.

# Option 1: Install and run via npm using npx (recommended)
npx mcp-philips-hue

# Option 2: Build from source
# Clone the repository
git clone https://github.com/m2ai-mcp-servers/mcp-philips-hue.git
cd mcp-philips-hue
npm install
npm run build

# Start the server after building (if a start script exists in package.json)
npm run start

Additional setup and configuration

Provide your Hue Bridge information and API key to enable communication with the Hue Bridge.

export HUE_BRIDGE_IP=192.168.1.x
export HUE_API_KEY=your-api-key-here

Claude Desktop configuration (example)

If you use Claude Desktop to orchestrate MCP servers, you can add this server configuration to your claude_desktop_config.json.

{
  "mcpServers": {
    "philips-hue": {
      "command": "npx",
      "args": ["-y", "mcp-philips-hue"],
      "env": {
        "HUE_BRIDGE_IP": "192.168.1.x",
        "HUE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available tools

get_lights

List all lights connected to your Hue Bridge.

set_brightness

Adjust brightness for a specific light or all lights, with a range from 0 to 254.

set_color

Change a light's color using a hex code, color name, or color temperature value.

toggle_light

Turn one or more lights on or off.