Complete a task
complete_taskMark a task as completed in Google Tasks. This reversible action returns the updated task and does not affect subtasks.
Instructions
Marks a task completed (status=completed; the API stamps the completed timestamp). This is REVERSIBLE — reopen_task undoes it — and is the right call for "done", unlike delete_task which erases the task. The API call touches only the addressed task: completing a parent does NOT cascade to its subtasks — complete them individually if the whole tree is done. A completed task stays listed until cleared: list_tasks still returns it with show_completed=true (+ show_hidden=true after a clear). Returns the updated task with status and completed.
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": "complete_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. |