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.
Changing your Home Assistant URL
If you move Home Assistant to a new address (for example, switching from a local address to your Nabu Casa URL), you need to paste your access token again when you change the URL. HoneyDone never sends your saved token to a different server, so the Save button won't accept a new URL on its own. HoneyDone tests the new URL and token together before saving them.
You can still update your tracked entity IDs without re-entering the token, as long as the URL stays the same.
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. - Addresses that point back at HoneyDone's own servers or at cloud provider internals (such as
127.0.0.1or169.254.169.254) are rejected. - Test connection only tells you whether Home Assistant answered, whether your token was rejected, or whether HoneyDone couldn't reach it. If the address answers but isn't Home Assistant, the test reports it as unreachable.
- Requests to Home Assistant time out after 10 seconds, and very large responses are rejected.
- HoneyDone does not require your Home Assistant to be exposed to the internet — a Nabu Casa or other tunnel works fine.