OpenHue MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
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)
- Docker
- 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:
- 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
- macOS:
- 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
You must be authenticated.
Enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.