update_task
Update a task's title, assignee, due date, reminders, notes or urgency. Only the fields you send change.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "018f2c9a1b2c7d3e9a4f5b6c7d8e9f0a",
"title": "Take out the recycling",
"dueDate": "2026-08-01"
},
"name": "update_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task id from create_task or list_tasks. | |
| notes | No | Freeform notes. Not for assignment info. | |
| title | No | New title. | |
| dueDate | No | New due date, YYYY-MM-DD. Empty string clears it. | |
| isUrgent | No | Mark the task urgent so it is shown first and highlighted: true marks urgent, false clears it, omit to leave unchanged. | |
| preparationDate | No | Legacy single reminder date, YYYY-MM-DD; use reminderOffsetMinutes instead. Ignored when reminderOffsetMinutes is sent. Must be on or before dueDate. Empty string clears it; clearing dueDate clears it. On a task without reminderOffsetMinutes, changing dueDate does not move it. On a task with reminderOffsetMinutes the server keeps it in step with dueDate: a different date replaces every reminder with that one, and an empty string removes them all. | |
| assignedToMemberId | No | Member id to assign. Empty string unassigns. | |
| reminderOffsetMinutes | No | New reminder lead times, in minutes before the due date. Send the full list: it replaces the current one. [] clears all reminders; omit to keep them. Each value is whole hours, 60-1380 (1-23 hours), or whole days, a multiple of 1440 up to 525600 (365 days); a week is 10080. Up to 5 values. A due date counts from 00:00 on that day, so 300 (5 hours) is 19:00 the evening before. Day and week reminders arrive at 19:00 on the earlier day; hour reminders arrive that many hours before, or up to 15 minutes earlier. Reminders move with dueDate, need a due date, and are cleared when dueDate is cleared. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| title | No | ||
| message | No | ||
| variant | No |