Skip to content
A Mycroft skill for controlling Phillips Hue lights
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
regex German Translation May 31, 2018
test/intent fix brightness intent test Jun 1, 2018
vocab German Translation May 31, 2018
LICENSE Create LICENSE Dec 2, 2016 Update for compatability with latest core version Oct 26, 2019
requirements.txt Use phue 1.0 instead of referencing commit Jan 27, 2018

Mycroft Hue

Control Phillips Hue Lights


Turn your Phillips Hue lights on/off, activate scenes, adjust brightness/color temperature, etc.


  • "Turn on my lights"
  • "Set my lights to tropical twilight"
  • "Turn the lights down"
  • "Decrease the color temperature of the lights"


  • @ChristopherRogers1991
  • @WillJMurphy
  • @gras64

Short Demo



You can install this skill by running: msm install hue.

Manual install

  1. Clone this repo into your third party skills folder (the current default is ~/.mycroft/skills, but it used to be ~/.mycroft/third_party_skills; check your global/local mycroft.conf files if you have issues)
  • cd ~/.mycroft/skills && git clone
  1. cd into the resulting mycroft-hue directory
  • cd ~/.mycroft/skills/mycroft-hue
  1. If your mycroft instance runs in a virtual environment, activate it
  • source ~/.virtualenvs/mycroft/bin/activate
  1. Install the required python libraries
  • pip install -r requirements.txt


Note: You may need to restart Mycroft (or at least the skills service), for configuration changes to take effect.

If you need to adjust any settings of this skill, you can do so at Alternatively:

Add the block below to your mycoft.conf file (~/.mycroft/mycroft.conf), and make any necessary adjustments there.

  "PhillipsHueSkill": {
    "ip": "",
    "username": "",
    "verbose": false,
    "brightness_step": 50,
    "color_temperature_step": 1000,
    "default_group": 0

If that file did not already exist (this is the first third party skill you have added), wrap that entire block in { }. The finished file should be valid json. If you have issues, use to validate the json.

If you know the ip address of your hub, or have a user that you would like to use, you may add either or both on the relevant lines above. Otherwise, the skill will attempt to find the hub on your network (if you have multiple, it will take the first one it finds), and will create a user.

On your first run, if you did not supply a username, when you say any phrase that gets routed to this skill (e.e. "turn off my lights"), you will be asked to push the button on the top of your Phillips Hue hub. This will create a user on the hub for this application.

Sample phrases

  1. Turn on my lights
  2. Set my lights to <scene name>, e.g. Set my lights to tropical twilight
  3. Turn the lights down
  4. Decrease the color temperature of the lights

The list above is non-exhaustive, but covers the bulk of the functionality. The phrasing is very flexible; as long as you hit a few key words (e.g. "lights" and "off") mycroft should be able to figure out what you want. You can add in a group name to any of the phrases as well, e.g. 'Shut the kitchen lights off'.

All groups and scenes are loaded from the hub, meaning any scenes or groups available to you in the hue app will be available through mycroft. If you do not specify a group name in your phrase, the default group (specified in the ini block above) will be used for the given action. These are loaded when mycroft lauches; if you want to pick up changes to your groups or scenes without relauching mycroft, you can say "reconnect my lights."

You can’t perform that action at this time.