create_task
Create a new OmniFocus task in the inbox, a project, or under a parent task. Optionally attach up to 5 existing tags.
Instructions
Create exactly one new OmniFocus task after an explicit user request. destination is required: Inbox, one exact Active Project canonical ID from a fresh get_project read, or one exact existing ordinary Action Group canonical ID from a fresh get_task read. Parent names, paths, leaf Actions, and Project roots are never accepted as Parent destinations. Optional tagIds accepts 1-5 unique canonical IDs of existing Active Tags selected from fresh search_tags results; names and paths are never mutation identifiers, all requested Tags and ancestors are revalidated immediately before creation, and this Tool never creates Tags. Immediately before a Project, Parent, or tagged call, restate the available target context and every full Tag path so the user can associate each canonical ID with the pending mutation; if any target is not distinguishable, do not call. Generate a fresh UUID idempotencyKey per new creation intent and reuse it only for a transparent retry. This server may return write_disabled without touching OmniFocus. Repeats, notifications, batches, edits, moves, reparenting, completion, deletion, fallback to Inbox/Project, silent Tag omission, and automatic Tag creation are unsupported.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| note | No | ||
| tagIds | No | 1-5 unique canonical IDs of existing OmniFocus Tags; names, paths, and automatic Tag creation are not accepted. | |
| dueDate | No | ||
| flagged | No | ||
| deferDate | No | ||
| destination | Yes | ||
| plannedDate | No | ||
| idempotencyKey | Yes | ||
| estimatedMinutes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| created | Yes | ||
| success | Yes | ||
| warnings | Yes | ||
| idempotency | Yes |