openhue

This MCP server exposes Philips Hue light control through the OpenHue CLI and makes it available to Claude and other LLM interfaces via the MCP protocol. The server supports commands for listing lights, controlling individual lights, adjusting brightness and color, and managing rooms and scenes. Available actions include getting lights (get-lights), controlling a light (control-light), listing rooms (get-rooms), controlling a room (control-room), listing scenes (get-scenes), and activating a scene (activate-scene). You can connect Claude Desktop or other MCP clients by configuring Claude's or your tool’s MCP settings to point at this server and invoking these capabilities through natural language prompts. Set up the OpenHue CLI beforehand so the server can read your Hue Bridge configuration and manage lights through the CLI if needed by your workflow.

To use, configure Claude Desktop (or your MCP client) to connect to the OpenHue MCP server, then issue natural language requests like: “List all lights in the living room,” “Turn on the kitchen lights,” or “Activate the Relaxing scene.” The server translates these requests into the corresponding get-lights, control-light, get-rooms, control-room, get-scenes, or activate-scene actions and returns structured results suitable for conversational use.

Prerequisites:

• Node.js v16 or higher
• Docker (for OpenHue CLI usage during bridge setup)

Installation steps:

1. Clone the repository:

git clone <your-repo-url>
cd claude-mcp-openhue

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Start the MCP server:

npm start

5. (Optional) Set up OpenHue CLI to connect to your Hue Bridge as described in the Bridge Setup section of the README, so the server can control your lights through the Hue Bridge.

Configure your MCP client (e.g., Claude Desktop) to connect to the server using the mcp_config guidance below.

Tips and common issues:

• Ensure Docker is running if you rely on the OpenHue CLI for bridge interaction during initial setup.
• The server uses Node.js; ensure your build/index.js path is correct in the mcp_config. Replace /absolute/path/to/build/index.js with the actual path after building.
• If you encounter connection issues, verify that the Hue Bridge is accessible and that the OpenHue CLI has been configured with the correct bridge and credentials.
• When testing with Claude Desktop, ensure the server appears connected in Claude’s config and restart Claude Desktop after adding the server.
• You can customize color and brightness inputs in the available commands (e.g., color names, 0-100 brightness range, color temperature values).
• If you modify the server code, rebuild and restart to apply changes.