Task Create¶
Create a new task in the master task list. Optionally attach a note file for details/subtasks. Slice 2 GTD vocabulary (task_kind, density, outcome_text, next_action_text, definition_of_done, creation_effort, user_involvement, creation_provenance, deadline, dependency) is optional and defaults to 'looks like a legacy manually-authored task'. Agent-driven creators should set creation_provenance (e.g. 'agent_inferred_from_journal') and lower user_involvement.
MCP name: task_create
Category: tasks
Mutates state (retry policy: verify_first)
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
contract |
str |
No | Contract slug this task serves |
creation_effort |
str |
No | Slice 2: 'sparse' |
creation_provenance |
str |
No | Slice 2: 'manual' (default) |
deadline_date |
str |
No | Slice 2: ISO date YYYY-MM-DD when has_deadline=True. |
definition_of_done |
str |
No | Slice 2: closing signal for the task. |
density |
str |
No | Slice 2: 'sparse' (default) |
dependency_hint |
str |
No | Slice 2: 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 | Slice 2: True when deadline_date is set; signal for deadline-aware resurfacing in Slice 8. |
has_dependency |
bool |
No | Slice 2: True when this task is blocked on someone or something. |
next_action_text |
str |
No | Slice 2: specific physical action for developed tasks (e.g. 'Set up weekly cron job'). |
outcome_text |
str |
No | Slice 2: desired end-state for developed tasks (e.g. 'ETF tracking habit running'). |
project |
str |
No | Project slug (added as #projects/ |
summary |
str |
No | If provided, creates a linked note file with this summary |
tags |
list[str] |
No | Namespace tags (no leading '#'), e.g. ['paper/ecg-classifier', 'experiment/augmentation']. Appended to the task line; picked up into the tag cache on next task_sync. |
task_kind |
str |
No | Slice 2: '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 | Slice 2: 'low' |
Requirements¶
- obsidian