OpenHue

by lsemenenko

9 stars
Not rated
GitHub

About

Integrates with Philips Hue smart lighting systems to enable automated control of light states, scenes, and schedules for complex home automation scenarios.

Details

Author
lsemenenko
Repository
lsemenenko/openhue-mcp-server
GitHub stars
9
License
MIT License
Categories
Other, Productivity, Developer Tools, Design, AI, Search, Automation, Frontend, API
Tags
#integration

This server exposes the following capabilities through MCP:

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name OpenHue
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /absolute/path/to/build/index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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. Run the server:

npm start

Before using the server, you need to set up the OpenHue CLI with your Hue Bridge:

1. Run the setup command:


1. Open your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

json
{
"mcpServers": {
"hue": {
"command": "node",
"args": ["/absolute/path/to/build/index.js"]
}
}
}

3. Restart Claude Desktop

4. Look for the hammer icon to verify the server is connected

bash
npm start
```

get-lights

Lists all lights or gets details for specific lights. Parameters: lightId (optional string), room (optional string)

control-light

Controls individual lights. Parameters: target (string), action ("on" | "off"), brightness (optional number), color (optional string), temperature (optional number)

get-rooms

Lists all rooms or gets specific room details. Parameters: roomId (optional string)

control-room

Controls all lights in a room. Parameters: target (string), action ("on" | "off"), brightness (optional number), color (optional string), temperature (optional number)

get-scenes

Lists available scenes. Parameters: room (optional string)

activate-scene

Activates a specific scene. Parameters: name (string), room (optional string), mode (optional "active" | "dynamic" | "static")

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "openhue": {
            "env": {},
            "args": [
                "/absolute/path/to/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "/absolute/path/to/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "env": [],
    "args": [
        "/absolute/path/to/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "env": [],
    "args": [
        "/absolute/path/to/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

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:

1. Run the setup command:
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.