> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enagrams.com/llms.txt
> Use this file to discover all available pages before exploring further.

# task_update

> Update a task's status

## Overview

Transition a task. Setting `status=done` triggers the unblock cascade on dependents.

## Status values

`todo` · `in_progress` · `blocked` · `done` · `cancelled`

## Parameters

| Parameter | Type   | Required | Description                               |
| --------- | ------ | -------- | ----------------------------------------- |
| `task_id` | string | Yes      | Task id                                   |
| `status`  | string | Yes      | New status                                |
| `note`    | string | No       | Free-form note recorded on the transition |

## Example

```json theme={null}
{
  "tool": "task_update",
  "arguments": { "task_id": "task_xyz", "status": "done" }
}
```

Prefer closing tasks via [`confirm_ready`](/mcp/confirm-ready) with `completes_task_id` so the transition is gated by tests.