What you get
Once it's connected, every (non-template) Nimblist list becomes its own Home Assistant todo entity. You can add, rename, check off, and remove items, and each change syncs to Nimblist in real time. That means you can:
- Add by voice — "add milk to the shopping list" via Assist, Alexa or Google (through Home Assistant) drops the item straight onto the shared list.
- Show it on a dashboard — put the list on a wall tablet or your phone's HA dashboard with the to-do card.
- Automate it — have an automation add "cat food" when a sensor says the bin is low, or remind you of the list when someone leaves work.
Install it via HACS
The integration is open-source and is listed in the HACS default store — there's no custom repository to add:
- In Home Assistant, open HACS and search for Nimblist.
- Install it, then restart Home Assistant.
(Prefer to do it by hand? Copy the custom_components/nimblist/ folder into your Home Assistant config/custom_components/ directory and restart.)
Connect your account with an API token
Home Assistant signs in with a revocable API token rather than your password — so it works no matter how you log in to Nimblist, including Google, Facebook or Microsoft sign-in.
- In the Nimblist web app, open Settings → API tokens, create one, and copy it (it's shown only once).
- In Home Assistant, go to Settings → Devices & Services → Add Integration → Nimblist.
- Enter your server URL (
https://nimblist.app, or your own address if you self-host) and paste the API token.
You'll get one to-do entity per active list. If you ever revoke the token, Home Assistant will simply prompt you to re-authenticate with a new one.
Self-hosting? It works there too
The server URL is configurable, so the integration points at a self-hosted Nimblist instance just as happily as the hosted app — handy if you keep your household data on your own hardware alongside Home Assistant.
The Home Assistant integration is free — and so are unlimited shared lists.
Get the integration on GitHub →Why it matters
The hardest part of a shared shopping list is remembering to add to it. Bringing it into Home Assistant means the list is wherever you already are — a voice command in the kitchen, a tablet by the door, or an automation that notices for you. Pair it with recipe import and the meal planner and most of your list builds itself.