Xbox Live

The Xbox Live component is able to track Xbox profiles.

To use this sensor you need a free API key from Please also make sure to connect your Xbox account on that site.

The configuration requires you to specify XUIDs which are the unique identifiers for profiles. These can be determined on by either looking at your own profile page or using their interactive documentation to search for gamertags.

To use the Xbox Live sensor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: xbox_live
    api_key: YOUR_API_KEY
      - account1
      - account2

Configuration variables:

  • api_key (Required): Your API key from
  • xuid (Required): Array of profile XUIDs to be tracked.