Skip to content

About

A custom integration for home assistant for generac and honeywell generators

Topics

Resources

Contributing

Stars

45 stars

Watchers

5 watching

Forks

 
 

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, 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

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

Readiness Tracking, Maintenance Timer & Repairs Alerts

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_service shows estimated runtime hours remaining until the configured service interval (default 100 hours, configurable via Options -> service_interval_hours; set to 0 to disable).
    • On first setup, the baseline initializes to the generator's current run_time to 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_exercise turns on if no Running/Exercising status or run-hour increase is observed within exercise_interval_days (default 16 days to cover weekly and biweekly schedules; set to 0 to disable).
  • Proactive Home Assistant Repairs Alerts:
    • low_battery_voltage: raised when generator starting battery voltage drops below low_battery_threshold (default 12.2 V).
    • missed_exercise: raised when the generator exceeds exercise_interval_days without observed activity.
    • maintenance_due: raised when runtime since the last service reset reaches service_interval_hours or Mobile Link reports a maintenance alert.
    • subscription_dunning: raised when Mobile Link reports a past-due/dunning subscription status.

Bundled Automation Blueprints

When the integration sets up, three ready-to-use automation blueprints are automatically installed to <config>/blueprints/automation/generac/:

  1. Generac Outage Load Shedding (generac_outage_load_shedding.yaml) — Sheds high-draw entities when status transitions to Running (ignoring Exercising cycles), waits for Ready stabilization, and optionally restores loads with a stagger delay.
  2. Generac Fault & Dealer Contact Alert (generac_fault_dealer_alert.yaml) — Sends a notification populated with generator status, diagnostic status_text, and your preferred dealer's name and phone number on Warning, Stopped, Communication Issue, warning, or maintenance alerts.
  3. 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 turns on.

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!

Session expiry (every ~90 days)

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

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

45 stars

Watchers

5 watching

Forks

Releases

Packages

Used by

Contributors

Languages