Set Todo Item
ha_set_todo_itemCreate or update a todo item in Home Assistant. Add new items with summary and optional details, or modify existing items by updating status, name, or due date.
Instructions
Create or update a todo item in Home Assistant.
WITHOUT item parameter (create mode): Creates a new item. summary is required.
WITH item parameter (update mode): Updates an existing item identified by UID or exact name. At least one update field (rename, status, description, due_date, due_datetime) is required.
EXAMPLES:
Add item: ha_set_todo_item("todo.shopping_list", summary="Buy milk")
Add with description: ha_set_todo_item("todo.shopping_list", summary="Buy milk", description="2% organic")
Add with due date: ha_set_todo_item("todo.tasks", summary="Pay bills", due_date="2024-12-31")
Complete item: ha_set_todo_item("todo.shopping_list", item="Buy milk", status="completed")
Rename item: ha_set_todo_item("todo.tasks", item="Old task", rename="New task name")
Update due date: ha_set_todo_item("todo.tasks", item="Pay bills", due_date="2024-12-31")
Reopen item: ha_set_todo_item("todo.tasks", item="Task to redo", status="needs_action")
NOTE: Not all todo integrations support all features (description, due dates). The Shopping List integration only supports summary.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Existing item to update - can be the item UID or the exact item summary/name. When provided, operates in update mode. When omitted, creates a new item. | |
| rename | No | New name/summary for an existing item. Only used in update mode. | |
| status | No | Item status: 'completed' to mark done, 'needs_action' to mark incomplete. Only used in update mode. | |
| summary | No | Item text/name. Required when creating a new item. Ignored in update mode — use 'rename' to change the item name. | |
| due_date | No | Due date in YYYY-MM-DD format (e.g., '2024-12-25') | |
| entity_id | Yes | Todo list entity ID (e.g., 'todo.shopping_list') | |
| description | No | Detailed description for the item | |
| due_datetime | No | Due datetime in ISO format (e.g., '2024-12-25T14:00:00'). Overrides due_date if both provided. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||