Home Integration (Home Assistant)
HoneyDone can connect to your Home Assistant instance to read presence and time-of-day signals. These signals help HoneyDone suggest prep work at the right time and avoid surfacing chores when nobody is home.
This integration is read-only. HoneyDone never sends commands, turns devices on or off, or writes any state back to Home Assistant.
What gets observed
HoneyDone polls Home Assistant periodically and derives two signals:
- Presence — whether your household is home or away, based on person and device tracker entities you configure.
- Time of day — morning, midday, evening, or night, based on your household's timezone.
These signals feed HoneyDone's orchestration and rhythm features — for example, surfacing prep tasks before you leave the house, or avoiding notifications late at night.
Setting up the connection
- In Home Assistant, open Profile → Security → Long-Lived Access Tokens and create a new token. Name it something like "HoneyDone" so you remember what it's for.
- Copy the token (you only see it once).
- In HoneyDone, go to Settings → Home.
- Enter your Home Assistant URL (e.g.
https://homeassistant.local:8123or your Nabu Casa cloud URL). - Paste your token into the Access Token field.
- Add the entity IDs you want HoneyDone to watch — person entities, device trackers, or presence sensors — one per line (e.g.
person.alice,person.bob,device_tracker.front_door). - Click Test connection to verify HoneyDone can reach your Home Assistant instance.
- Click Connect to save.
Connection health
After connecting, the settings page shows a status badge:
| Status | Meaning |
|---|---|
pending | Connection saved, first poll hasn't run yet |
connected | Last poll succeeded |
error | Last poll failed — hover to see the error message |
disconnected | You have manually disconnected |
If the connection enters error state, check that your Home Assistant is reachable from the internet and that your token hasn't been revoked. Fix the issue, then click Test connection to reset.
The Recent Signals widget on the settings page shows the last 20 presence and time-of-day observations HoneyDone has received.
Disconnecting
Click Disconnect on the settings page. Your token is deleted immediately. The historical presence signals HoneyDone has already recorded are kept as household data, but no new signals will be collected.
Security notes
- Your Home Assistant token is encrypted before being stored. It is never shown in the UI after you save it.
- Local network addresses (e.g.
192.168.x.x,10.x.x.x) are supported so you can connect to a Home Assistant instance on your home network. - HoneyDone does not require your Home Assistant to be exposed to the internet — a Nabu Casa or other tunnel works fine.