Home Assistant's push notifications fail exactly when you need them: no data on the phone you carry, battery saver, or the companion app killed by the OS. A text message still gets through. Here's a notify integration that sends real SMS through an Android phone you own, from your number, so there's no SMS provider in between and no per-message fee.
What you need
- An Android phone with a SIM card. It sends the texts.
- The free SMSTunnel app on that phone, signed in to your SMSTunnel account.
- The custom integration, from HACS.
1. Install the integration
HACS → three-dot menu → Custom repositories → add https://github.com/narcisbodea/hass-smstunnel with category Integration → install SMSTunnel → restart Home Assistant.
No HACS? Copy custom_components/smstunnel into config/custom_components/ and restart.
2. Get a key
In the SMSTunnel dashboard, open Apps → Add an app, pick Home Assistant and click Create the key. Copy it right away: it's shown only once. Stopping or deleting the app there cuts Home Assistant off at once.
3. Configure
Settings → Devices & Services → Add Integration → SMSTunnel:
| Field | Notes |
|---|---|
| API key | Checked during setup, so a wrong key fails now, not at the first real alert |
| Recipients | One or more numbers, comma separated |
| Server URL | https://smstunnel.io |
| Default country code | e.g. +40, so numbers without a prefix still work |
| Device ID | Optional: pins sending to one phone |
4. Use it in automations
The integration adds the action notify.smstunnel:
automation:
- alias: "SMS on water leak"
triggers:
- trigger: state
entity_id: binary_sensor.basement_water_leak
to: "on"
actions:
- action: notify.smstunnel
data:
title: "Home Assistant"
message: "Water leak detected in the basement!"
The title goes in front of the message, since a text has no title field. To text other numbers for one call, add target:
action: notify.smstunnel
data:
message: "The alarm was triggered"
target:
- "+14155550123"
- "+14155550199"
Each number gets its own text. YAML written before Home Assistant 2024.8 says service: instead of action:; both work.
Good to know
-
Flapping sensors: a trigger that fires over and over can burn through your texts in minutes. Add
for:or a condition. - Limits: 30 texts a minute; past that, the log says so plainly. Texts over 1600 characters are cut, not rejected.
- Phone offline? The text waits and goes out when the phone is back.
- Outages: Home Assistant and the phone still need internet to hand the alert over. For power or internet outages, keep the router and Home Assistant on a UPS, and leave the phone's mobile data on.
- The free plan has 25 texts a day, plenty for home alerts.
Full guide, with a prompt that has an AI assistant write the automations for you: https://smstunnel.io/integrations/home-assistant/
Disclosure: I build SMSTunnel. This post was written with AI from the official setup guide linked above.
Top comments (0)