Skip to content

binarydev/ha-generac

 
 

Repository files navigation

Warning

This is an unofficial Generac MobileLink integration. Generac systems may change at anytime, which would break the functionality of this integration, and it should not be used for anything mission critical. If you would like an alternative for whole-home generators that allows you to drop the need to maintain a MobileLink subscription, please see the ongoing discussions here for local hardware solutions using GenMon and Raspberry Pi's. Shoutout to Jeff Terrace for his blog post documenting how to set this up, so others can benefit from his experience!

As of July 26, 2026, this integration currently support logging in with your MyGenerac/MobileLink username and password to expose your devices to Home Assistant for monitoring and automation.

Generac MobileLink/MyGenerac Home Assistant Integration

hacs

Custom Generac integration component with support for generators and propane tank monitors. It will set up the following platforms.

Platform Entities created for each generator
binary_sensor is_connected, is_connecting, has_maintenance_alert, has_warning
sensor status, run_time, protection_time, activation_date, last_seen, connection_time, battery_voltage, device_type, dealer_email, dealer_name, dealer_phone, address, status_text, status_label, serial_number, model_number, device_ssid, panel_id
Platform Entities created for each propane tank monitor
binary_sensor is_connected, is_connecting, has_maintenance_alert, has_warning
sensor status, capacity, fuel_level, fuel_type, orientation, last_reading_date, battery_level, address, device_type

example

Installation (with HACS)

NOTE: If you've previously installed this integration, delete it first from Settings -> Integrations and delete the "Custom Repository" entry in HACS (found in HACS -> Integrations -> 3 dot menu on the top right)

Click this button to skip steps 1 and 2 below: Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  1. On the HACS -> Integrations page, click the Explore & Download Repositories button
  2. Search the list for generac and select it to open the details page
  3. On the bottom right, click the Download button
  4. Restart Home Assistant (not the quick reload option)
  5. Once Home Assistant comes back online, go to Settings -> Integrations
  6. Click the Add Integration button
  7. Search the list for generac and select it
  8. Enter your MyGenerac email and password (the same credentials you use in the MobileLink mobile app).
  9. If your account has two-factor authentication, a second screen asks for the verification code sent by text (SMS), your authenticator app, or email. Enter the most recent code and submit. (Push-prompt or security-key 2FA can't be completed here — approve the login in the MobileLink app, or switch your Generac/ecobee account to code-based 2FA, then retry.)
  10. The integration should initialize and begin pulling your device information within seconds

Installation (without HACS)

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called generac.
  4. Download all the files from the custom_components/generac/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "generac"
  8. Enter your MyGenerac email and password (the same credentials you use in the MobileLink mobile app).
  9. If your account has two-factor authentication, a second screen asks for the verification code sent by text (SMS), your authenticator app, or email. Enter the most recent code and submit. (Push-prompt or security-key 2FA can't be completed here — approve the login in the MobileLink app, or switch your Generac/ecobee account to code-based 2FA, then retry.)
  10. The integration should initialize and begin pulling your device information within seconds

Configuration is done in the UI

Username + Password Authentication

This integration previously used a cookie-fishing authentication workflow. As of PR #267, it has now been replaced by a standard OAuth workflow similar to the mobile app, using your username and password, with auto-refreshing token retrieval. You no longer need to enter your cookie's string!

Important

Fair Warning

Status Quo in summer 2026: This is an unofficial Generac integration, which requires using undocumented APIs in order to access the data of your Generac devices using your username and password. This is because Generac has changed (once again) the authentication workflow to actively block third-party access. They also originally stated that Home Assistant users were overloading their API. We have since adjusted accordingly to adapt to the new authenatication method and reduced our default polling interval from every 30 seconds to every 120 seconds, to be a "good" user of the API and cut the volume of traffic to their servers by 75%. This polling interval can also be tuned to your needs in the options panel of the HA integration once you have set it up, as seen here.

This approach implies that when Generac is going to change something in their non-public/undocumented API, it's quite likely that the integration will break instantly.

It's impossible to predict when this will happen, but I will try to keep the integration up-to-date and working as long as possible.

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines

Credits

This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.

Code template was mainly taken from @Ludeeus's integration_blueprint template

Forked from the original implementation created by @bentekkie


About

A custom integration for home assistant for generac and honeywell generators

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages