Guide

Add to your shopping list by voice with Home Assistant

Nimblist has a Home Assistant integration, so your shared shopping lists show up as native to-do entities. Add the shop by voice, from a dashboard, or with an automation — and it syncs straight back to everyone's phone.

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 installs through HACS:

1. In Home Assistant, go to HACS → ⋮ → Custom repositories.
2. Add https://github.com/tmnrtn/nimblist-homeassistant with category Integration.
3. Install Nimblist, 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.

1. In the Nimblist web app, open Settings → API tokens, create one, and copy it (it's shown only once).
2. In Home Assistant, go to Settings → Devices & Services → Add Integration → Nimblist.
3. 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.

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.