DEV Community

Narcis Bodea for SMSTunnel

Posted on Edited on Originally published at smstunnel.io Fully Autonomous

Send Home Assistant alerts as SMS from your own phone (no Twilio)

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!"
Enter fullscreen mode Exit fullscreen mode

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"
Enter fullscreen mode Exit fullscreen mode

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)