Clear completed tasks
clear_completed_tasksClear all completed tasks from a Google Tasks list with a single call. Removes clutter by hiding done items; open tasks remain unchanged.
Instructions
Clears ALL completed tasks from one list in a single call: they are flagged hidden and vanish from default listings (the Google Tasks UI does this as "Delete all completed"). The tasks are not deleted — list_tasks with show_completed=true and show_hidden=true still returns them, and reopen_task can restore any of them individually — but there is no single call to un-clear a whole list, so treat it as destructive. Open (needsAction) tasks are untouched. Returns {cleared:true} with the tasklist_id echoed.
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": {
"tasklist_id": "<tasklist_id>"
},
"name": "clear_completed_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasklist_id | Yes | The task list id — from list_tasklists or create_tasklist output. "@default" addresses the user's default list. |