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, missed_exercise |
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, hours_until_service |
button |
reset_service_timer |
| 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
Each generator automatically tracks exercise activity and maintenance runtime baselines using Home Assistant storage (persisting cleanly across restarts without reloading the integration):
- Maintenance Service Timer:
sensor.<generator>_hours_until_serviceshows estimated runtime hours remaining until the configured service interval (default100hours, configurable via Options ->service_interval_hours; set to0to disable).- On first setup, the baseline initializes to the generator's current
run_timeto avoid false day-1 alarms. - After completing maintenance (oil change, filter, etc.), press Reset Maintenance Timer (
button.<generator>_reset_maintenance_timer) on the device page to reset the baseline to the current run hours and clear any timer-based Repairs issue immediately.
- Exercise Readiness Tracking:
binary_sensor.<generator>_missed_exerciseturnsonif noRunning/Exercisingstatus or run-hour increase is observed withinexercise_interval_days(default16days to cover weekly and biweekly schedules; set to0to disable).
- Proactive Home Assistant Repairs Alerts:
low_battery_voltage: raised when generator starting battery voltage drops belowlow_battery_threshold(default12.2V).missed_exercise: raised when the generator exceedsexercise_interval_dayswithout observed activity.maintenance_due: raised when runtime since the last service reset reachesservice_interval_hoursor Mobile Link reports a maintenance alert.subscription_dunning: raised when Mobile Link reports a past-due/dunning subscription status.
When the integration sets up, three ready-to-use automation blueprints are automatically installed to <config>/blueprints/automation/generac/:
- Generac Outage Load Shedding (
generac_outage_load_shedding.yaml) — Sheds high-draw entities when status transitions toRunning(ignoringExercisingcycles), waits forReadystabilization, and optionally restores loads with a stagger delay. - Generac Fault & Dealer Contact Alert (
generac_fault_dealer_alert.yaml) — Sends a notification populated with generator status, diagnosticstatus_text, and your preferred dealer's name and phone number onWarning,Stopped,Communication Issue, warning, or maintenance alerts. - Generac Pre-Storm Readiness Digest (
generac_storm_readiness_digest.yaml) — Sends a readiness digest with status, connectivity, battery voltage, hours until service, and optional propane fuel level when a weather alert or trigger entity turnson.
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!
Generac's sign-in sessions expire 90 days after you log in, no matter how often the integration uses them. You have two options:
- Remember password (checkbox at sign-in, reauth and reconfigure): the password is stored in Home Assistant and the integration signs in again on its own when the session expires. This doesn't work for accounts that require a verification code (SMS / email / authenticator), because the code can't be entered unattended.
- Without it: a Repairs warning appears about 10 days before expiry. Use Reconfigure on the integration to sign in again before your devices stop updating.
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
