Task Create¶

Create a native task and optionally provision a projection-free Co-work knowledge document. GTD vocabulary is optional; agent-driven creators should set creation_provenance and appropriate user_involvement.

MCP name: task_create

Category: tasks

Mutates state (retry policy: verify_first)

Parameters¶

Name	Type	Required	Description
`client_mutation_id`	`str`	No	Optional stable idempotency key. The gateway pins one before dispatch when omitted.
`contract`	`str`	No	Contract slug this task serves
`creation_effort`	`str`	No	'sparse'
`creation_provenance`	`str`	No	'manual' (default)
`deadline_date`	`str`	No	ISO date YYYY-MM-DD when has_deadline=True.
`definition_of_done`	`str`	No	closing signal for the task.
`density`	`str`	No	'sparse' (default)
`dependency_hint`	`str`	No	free-text hint about the dependency (e.g. 'needs Ben’s review').
`due_date`	`str`	No	Due date as YYYY-MM-DD
`has_deadline`	`bool`	No	True when deadline_date is set; signal for deadline-aware resurfacing.
`has_dependency`	`bool`	No	True when this task is blocked on someone or something.
`next_action_text`	`str`	No	specific physical action for developed tasks (e.g. 'Set up weekly cron job').
`outcome_text`	`str`	No	desired end-state for developed tasks (e.g. 'ETF tracking habit running').
`project`	`str`	No	Project slug stored as a structured project tag.
`summary`	`str`	No	If provided, creates a linked Co-work knowledge document with this initial content.
`tags`	`list[str]`	No	Structured namespace tags without a leading '#'.
`task_kind`	`str`	No	'task' (default)
`task_text`	`str`	Yes	Short single-line task description (NO newlines — will be rejected)
`urgency`	`str`	No	Urgency: low, medium (default), high
`user_involvement`	`str`	No	'low'

Details¶

The creating agent session is recorded automatically as created_by_session; it is not a caller parameter. The result includes the native task ID, task and collection revisions, a durable mutation receipt, and Co-work document metadata when summary provisions knowledge. It never returns a Markdown task line or note path. Replaying the same client_mutation_id after response loss returns the original semantic result.