Remove an item
remove_itemDeletes an item from a list entirely, as if it had never been added. This is the tool for an item the user no longer wants: 'take milk off the list', 'I don't need the eggs after all'.
It is one of four tools that take an item off a list, and they differ by reason. check_off_item marks an item as bought and keeps it on the list. out_of_item moves an item from the pantry onto the shopping list. consume_items records that pantry items were used up while cooking. This one simply deletes, leaving no record.
Matching is loose, so 'milk' matches 'whole milk'. When several items match, the closest one is removed. Returns the removed item and the list it came from, and reports an error without changing anything when nothing matches.
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": {
"name": "<name>"
},
"name": "remove_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Item name to delete, as the user said it, e.g. 'milk'. Matched loosely against the names on the list. | |
| listId | No | Which list to remove from, using an id from search_lists. Omit to use the user's current shopping list, which is almost always what they mean. |