Remove Todo Item
ha_remove_todo_itemRemove specific items or all completed entries from a Home Assistant todo list by entity ID, enabling cleanup of shopping or task lists.
Instructions
Remove items from a Home Assistant todo list.
Give item or remove_completed=True, not both. Removal is permanent;
to mark an item done instead, use ha_set_todo_item() with
status="completed". removed lists the items the call asked for that
are gone afterwards; with remove_completed=True that includes a
completed item another client removed meanwhile. With auto-backup on,
each item is backed up before it is removed; warnings names a backup
not taken because the item could not be read or the backup could not
start, and with remove_completed=True an item gone afterwards that was
not completed when the list was read, so was not backed up.
EXAMPLES:
ha_remove_todo_item("todo.shopping_list", "Buy milk")
ha_remove_todo_item("todo.shopping_list", ["Buy milk", "Bread"])
ha_remove_todo_item("todo.shopping_list", remove_completed=True)
If a Claude Desktop user gets a 4-minute timeout with no result on this call, read the target back before repeating it, and tell them to wait a few seconds before clicking the manual-approve button, as clicking it too quickly is known to cause hangs in Claude Desktop. This workaround is specific to Claude Desktop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity_id": "<entity_id>"
},
"name": "ha_remove_todo_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Item to remove, or a list of items - each the item UID (from ha_get_todo) or the exact item summary/name. A string that names no item but holds a JSON array of strings is that list. | |
| entity_id | Yes | Todo list entity ID (e.g., 'todo.shopping_list') | |
| remove_completed | No | Remove every completed item |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||