Home Assistant Integration
Connect Gubbins to Home Assistant and your inventory becomes part of your smart home — ask a voice assistant "where are my allen keys?", or surface stock levels as entities for automations and dashboards. This runs through the bridge.
Where to find it: the Home Assistant screen (in the menu, when the module is enabled) — which includes a built-in, step-by-step setup guide.
💡 Tip You don't have to piece this together yourself. The Home Assistant screen has a guided, step-by-step wizard — Overview → Access token → Run the bridge → Feed it data → Install in HA → Connect → Voice sentences → Try it — that adapts to your choices and gives copy-and-paste commands. It's the easiest way in.
ℹ️ Note This is an enthusiast feature that assumes you already run Home Assistant and the bridge. The in-app guide walks you through everything; the authoritative reference lives in the bridge
READMEin the Gubbins repository.
- Ask where things are. A custom integration answers spoken "where is / where are my…" questions, speaking the location back — Gubbins does the lookup and Home Assistant relays it.
- See stock as entities. Via MQTT discovery, Gubbins can publish summary figures (like low/out-of-stock counts) that appear automatically as Home Assistant entities — ready for dashboards and automations.
- Automate on changes. Because the bridge emits change events, you can trigger Home Assistant automations from inventory changes (e.g. notify when something runs low).
The bridge can advertise itself on your network (mDNS/zeroconf), so Home Assistant can discover it rather than you typing addresses — an opt-in, locally-gated convenience.
If you choose to enable it, Home Assistant can also adjust stock through the bridge — a peer device that writes back through Gubbins' safe merge so it can't cause drift. Write-back is off by default.
⚠️ Heads-up Exposing the bridge to Home Assistant means it's reachable on your LAN. Use a strong token, keep write-back off unless you need it, and treat the whole setup as trusted-network only. See Privacy & security.
- Bridge overview and Running the bridge — the foundation.
- AI assistant query (MCP) — the same lookups for AI assistants.
- Webhooks, MQTT & iCal — events, MQTT and calendar in detail.