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.
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 |
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:
- On the HACS -> Integrations page, click the
Explore & Download Repositoriesbutton - Search the list for
generacand select it to open the details page - On the bottom right, click the
Downloadbutton - Restart Home Assistant (not the quick reload option)
- Once Home Assistant comes back online, go to Settings -> Integrations
- Click the
Add Integrationbutton - Search the list for
generacand select it - Enter your MyGenerac email and password (the same credentials you use in the MobileLink mobile app).
- 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.)
- The integration should initialize and begin pulling your device information within seconds
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml). - If you do not have a
custom_componentsdirectory (folder) there, you need to create it. - In the
custom_componentsdirectory (folder) create a new folder calledgenerac. - Download all the files from the
custom_components/generac/directory (folder) in this repository. - Place the files you downloaded in the new directory (folder) you created.
- Restart Home Assistant
- In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "generac"
- Enter your MyGenerac email and password (the same credentials you use in the MobileLink mobile app).
- 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.)
- The integration should initialize and begin pulling your device information within seconds
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
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.
If you want to contribute to this please read the Contribution guidelines
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
