Skip to content
Home Assistant BridgeHome Assistant Bridge
Esc
↑↓navigate↵open⌘Jpreview
On this page

To-do lists

Read, add, change and remove to-do list items.

todo get prints a list’s items as JSON. --status limits it to needs_action or completed items:

ha-bridge todo get shopping
ha-bridge todo get shopping --status needs_action

Changing items

ha-bridge todo add milk shopping
ha-bridge todo add "Book MOT" chores --due-date 2026-11-01 --description "Before the 14th"
ha-bridge todo update milk shopping --status completed
ha-bridge todo update "Book MOT" chores --rename "Book MOT and service"
ha-bridge todo remove shopping --item milk --item bread
ha-bridge todo remove-completed shopping

Items are matched by name or UID. Set at most one of --due-date and --due-datetime.

Command Home Assistant action
todo get todo.get_items
todo add todo.add_item
todo update todo.update_item
todo remove todo.remove_item
todo remove-completed todo.remove_completed_items

See ha-bridge todo for every argument and flag.

Last updated on