Delete a task
delete_taskPermanently remove a task and its subtasks from your Google Tasks list. Use when you need to delete a task for good, not just mark it complete.
Instructions
Deletes a task permanently — this is NOT the same as completing it. To mark work done (reversibly), use complete_task instead. A deleted task disappears from default listings immediately; for a while it remains visible to list_tasks with show_deleted=true (deleted:true) so sync clients can observe the deletion, then it is gone for good. Deleting a parent task also deletes its subtasks. Returns {deleted:true} with the ids 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>",
"task_id": "<task_id>"
},
"name": "delete_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | The task id — from list_tasks, get_task or create_task output. | |
| tasklist_id | Yes | The task list id — from list_tasklists or create_tasklist output. "@default" addresses the user's default list. |