Google Tasks: Update a task — MCP tool
Google Tasks MCP tool: Changes a task's title, notes and/or due date with PATCH semantics.
Technical name: update_task
What task it solves
I want to edit a task.
Updates a task's title, notes and/or due — only the provided fields are touched; at least one is required.
When to use it
Use it for content edits. Status and position are deliberately elsewhere: complete_task / reopen_task for completion, move_task for order and hierarchy.
What to provide
tasklist_id— required."@default"targets the default list.task_id— required. The task id from list_tasks or create_task output.title— optional. New title (1..1024 characters).notes— optional. New notes (max 8192 characters).due— optional. New due date, e.g."2026-09-01"(date only is stored).clear_due— optional. Remove the due date (mutually exclusive with due).clear_notes— optional. Remove the notes (mutually exclusive with notes).
What it returns
The updated task.
What changes in Google Tasks
The named fields are overwritten in place; everything else on the task stays as it was. Overwritten values are not recoverable — re-send the old value to revert.
Example request
Change the due date of "Send the report" to next Monday in Google Tasks.
Errors and limitations
clear_due / clear_notes remove a field properly (an empty string would be stored verbatim). due stores only the calendar date. Passing no field at all, or a field together with its clear flag, is rejected before any network call.
Access also depends on token permissions, quotas, and upstream API limits.
Related MCP tools
- Get a task —
get_task - Complete a task —
complete_task - Move a task —
move_task
Technical details
- Impact: changes data (overwrites only the fields provided)
- Group: Tasks
- Description source:
update_taskregistration insrc/tools/tasks.ts - Full technical reference
- All MCP capabilities