philips-hue

Control Philips Hue lights via a command-line interface with JSON output.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/thomaspurves/philips-hue-cli --skill philips-hue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: philips-hue
Source: https://github.com/thomaspurves/philips-hue-cli/tree/main/skills/philips-hue
Command: npx skills add https://github.com/thomaspurves/philips-hue-cli --skill philips-hue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Philips Hue lights are easy to control manually but automating or scripting lighting workflows can be tedious without a CLI. This skill provides a robust command-line interface to manage Hue lights, query state, and apply batch actions—without needing a GUI.

Core Features & Use Cases

  • Authenticate to the mocked Hue bridge and manage credentials
  • List all lights and query individual light state
  • Set lights on/off by ID or by room, and reset all lights to defaults
  • Retrieve version/schema information and ensure compatibility for automation
  • Output machine-readable JSON envelopes for scripting and agents, with consistent error handling

Quick Start

Install the CLI, authenticate, and run a sample command to turn on kitchen lights with JSON output.

Frequently Asked Questions about philips-hue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Philips Hue lighting control from the command line?

Automate Philips Hue lighting control by using a CLI to authenticate with a Hue bridge, list devices, and set light states by ID or room, receiving structured JSON output for scripting workflows.

Can I get JSON output from Philips Hue API requests for machine consumption?

Yes, JSON output is enforced for machine consumption. The CLI returns structured JSON envelopes for commands querying light states, listing devices, and handling errors, ensuring compatibility for automation agents.

How do I batch set Hue lights on or off by room without a GUI?

Batch set Hue lights without a GUI by running CLI commands that target lights by room name or ID, toggling on/off states and resetting all lights to defaults while returning structured JSON responses.

Does the Hue CLI require a real Hue bridge to function for testing?

The Hue CLI requires a real or mocked Hue bridge to function. It manages authentication credentials against the bridge, allowing development and testing of lighting automation workflows without physical hardware.

What is the best way to script Philips Hue light state queries for automation?

Script Philips Hue light state queries by chaining CLI commands that authenticate, list devices, and query individual lights, ensuring consistent machine-readable JSON envelopes for reliable automation pipelines.