The WxAlerts integration brings the places on your
wxalerts.org account into Home Assistant. Each place becomes a device
named WxAlerts <place>, with:
- Storm cell alerts. When a storm cell’s forecast path threatens the place, a safety sensor turns on with the arrival time, threat level, probabilities, speed, bearing and distance.
- NWS alerts for the place’s county: an active alert sensor, the highest severity, the full alert list, the top alert, and a binary sensor for each warning type you pick.
- Events and device triggers for automations, ready in the automation editor.
Alerts are pushed, not polled. They arrive when they are issued and clear when they end. Add, rename or delete a place on wxalerts.org and Home Assistant follows within seconds, with no restart.
What you need
| Plan | Supporter, which includes 1 Home Assistant instance |
| Home Assistant | 2025.2.0 or newer, with My Home Assistant enabled (the default) |
| Integration | 1.0.0, installed with HACS |
| Source | github.com/wxalerts/WxAlerts-HA |
You do not need the Home Assistant MQTT integration or a broker of your own. The integration brings its own client.
Set it up
- Install with HACS. Open HACS, then the menu, then Custom
repositories. Add
https://github.com/wxalerts/WxAlerts-HAas an Integration, install WxAlerts and restart Home Assistant. - Add the integration. Open Settings, Devices & services, Add integration and choose WxAlerts.
- Sign in. Home Assistant opens the WxAlerts sign in. Sign in with your Supporter account and approve.
That is it. Home Assistant registers itself as an instance on your account and
creates one device per saved place, plus an account device named WxAlerts. A
place you add later on wxalerts.org shows up on its own.
To install by hand instead of HACS, copy custom_components/wxalerts from the
repo into your config/custom_components folder and restart.
Instances
Each Home Assistant install that signs in is one instance, with its own login. Supporter includes 1 instance, and each Top-up adds 1 more. Every instance gets the same places and alerts.
Your instances are listed on the Home Assistant card of your account, with when each was added and last seen. Setting up the same Home Assistant again reuses its slot rather than taking a new one.
If your plan ends or a Top-up is removed, the newest instances over the limit are turned off first and marked Deactivated on the card. The oldest keep working.
Revoking an instance
Press Revoke next to it on the Home Assistant card. It disconnects at once and frees its slot. To bring it back, sign in again from Home Assistant.
Options
Settings, Devices & services, WxAlerts, Configure: pick the NWS alert types that get a binary sensor on each place. A fresh install picks the warnings that can harm someone asleep: Tornado, Severe Thunderstorm, Flash Flood, Extreme Wind, Hurricane, Blizzard, Ice Storm, Snow Squall and Tsunami. Every other type is still available as a device trigger.
Places themselves are managed on wxalerts.org, not in Home Assistant.
Next
- Entities and events: every sensor, attribute and event.
- Automations: YAML for storm cells and warnings.
- Upgrading from 0.x: what 1.0 removes and what to repoint.
- MQTT topics: the same feed for Node-RED or your own client.
- Troubleshooting

