A
securityA
licenseA
qualityIntegrate Claude with Any OpenAI SDK Compatible Chat Completion API - OpenAI, Perplexity, Groq, xAI, PyroPrompts and more.
Last updated -
1
27
140
MIT License
The OpenHue MCP Server allows you to control Philips Hue lights through Claude and other LLM interfaces.
Lights Control: List all lights, get specific light details, turn lights on/off, adjust brightness (0-100%), set colors by name, and control color temperature (153-500 Mirek)
Room Control: List all rooms, get room details, control all lights in a room together, set room-wide brightness and colors
Scene Management: List available scenes (filterable by room), and activate scenes with different modes (active, dynamic, or static)
Provides comprehensive control of Philips Hue lighting systems through the OpenHue CLI, including turning lights on/off, adjusting brightness, setting colors, controlling color temperature, managing rooms, and activating scenes.
OpenHue MCP Server
An MCP server that enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
Prerequisites
Node.js (v16 or higher)
Claude for Desktop (optional, for testing)
Bridge Setup
Before using the server, you need to set up the OpenHue CLI with your Hue Bridge:
Run the setup command:
# On Linux/macOS:
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
Follow the on-screen instructions:
The CLI will search for your Hue Bridge
Press the link button on your Hue Bridge when prompted
Wait for confirmation that the setup is complete
Verify the setup by listing your lights:
# On Linux/macOS:
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights
# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights
If you see your lights listed, the setup is complete and you're ready to use the MCP server.
Installation
Clone the repository:
git clone <your-repo-url>
cd claude-mcp-openhue
Install dependencies:
npm install
Build the project:
npm run build
Run the server:
npm start
Features
This server exposes the following capabilities through MCP:
Lights Control
List all lights or get specific light details
Turn lights on/off
Adjust brightness
Set colors
Control color temperature
Room Control
List all rooms or get room details
Control all lights in a room together
Set room-wide brightness and colors
Scene Management
List available scenes
Activate scenes with different modes
Filter scenes by room
Usage with Claude Desktop
Open your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the server configuration:
{
"mcpServers": {
"hue": {
"command": "node",
"args": ["/absolute/path/to/build/index.js"]
}
}
}
Restart Claude Desktop
Look for the hammer icon to verify the server is connected
Example Commands
Once connected, you can ask Claude natural language questions like:
"What lights do I have in the living room?"
"Turn on all the lights in the kitchen"
"Set the bedroom lights to 50% brightness"
"Change the office lights to blue"
"Activate the 'Relaxing' scene"
"What scenes are available in the den?"
Available Tools
get-lights
Lists all lights or gets details for specific lights
{
lightId?: string; // Optional light ID or name
room?: string; // Optional room name filter
}
control-light
Controls individual lights
{
target: string; // Light ID or name
action: "on" | "off";
brightness?: number; // 0-100
color?: string; // Color name
temperature?: number; // 153-500 Mirek
}
get-rooms
Lists all rooms or gets specific room details
{
roomId?: string; // Optional room ID or name
}
control-room
Controls all lights in a room
{
target: string; // Room ID or name
action: "on" | "off";
brightness?: number;
color?: string;
temperature?: number;
}
get-scenes
Lists available scenes
{
room?: string; // Optional room name filter
}
activate-scene
Activates a specific scene
{
name: string; // Scene name or ID
room?: string; // Optional room name
mode?: "active" | "dynamic" | "static";
}
Development
Project Structure
.
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md
Building
npm run build
Running
npm start
Troubleshooting
Server Not Connecting
Check that Docker is running
Verify OpenHue configuration exists
Check Claude Desktop logs
Try running OpenHue CLI directly
Command Failures
Check OpenHue CLI permissions
Verify light/room/scene names
Check Docker container logs
Verify Hue Bridge connectivity
License
MIT License
Contributing
Fork the repository
Create your feature branch
Commit your changes
Push to the branch
Create a new Pull Request
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
Related MCP Servers
- -securityAlicense-qualityEnables users to control Govee LED devices using the Govee API, with features for turning devices on/off, setting colors, and adjusting brightness through a CLI or MCP clients.Last updated -3MIT License
- -securityFlicense-qualityA Model Context Protocol interface that enables AI assistants like Claude to control Philips Hue smart lighting systems through natural language commands.Last updated -10
- -securityAlicense-qualityEnables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.Last updated -5MIT License