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](https://nodejs.org/) (v16 or higher)
- [Docker](https://www.docker.com/get-started)
- [Claude for Desktop](https://claude.ai/download) (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:
- 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:
If you see your lights listed, the setup is complete and you're ready to use the MCP server.
Installation
- Clone the repository:
- Install dependencies:
- Build the project:
- Run the server:
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.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Add the server configuration:
- 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
control-light
Controls individual lights
get-rooms
Lists all rooms or gets specific room details
control-room
Controls all lights in a room
get-scenes
Lists available scenes
activate-scene
Activates a specific scene
Development
Project Structure
Building
Running
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