Task Change State

Update task metadata: state (not completion), urgency, due date. Cannot set state='done' — use task_toggle for completion.

MCP name: task_change_state

Category: tasks

Mutates state (retry policy: verify_first)

Parameters

Name	Type	Required	Description
client_mutation_id	str	No	Optional stable idempotency key.
description_match	str	No	Description substring (fallback)
due_date	str	No	Due date as YYYY-MM-DD
expected_revision	int	No	Current task revision for compare-and-swap; the gateway pins it when omitted.
snooze_until	str	No	ISO date or datetime used when state is snoozed.
state	str	No	New state: inbox, mit, focused, snoozed. NOT done — use task_toggle.
task_id	str	No	Task ID (e.g., 't-xxxxxxxx')
urgency	str	No	New urgency: low, medium, high