task_create_describe
Preview a new task in OmniFocus without creating it. Inspect planned changes before calling the actual create tool.
Instructions
Preview what task_create would do without making any changes. Do NOT use to actually create a task — use task_create instead. Returns { description, plannedChanges } describing the task that would be created. No side effects: read-only by contract — never mutates OmniFocus. Example: dry-run companion — pass the same args you would to the write tool, inspect plannedChanges, then call the write tool once approved.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Task name. Required, must be non-empty. | |
| note | No | Plain-text note. | |
| tagIds | No | Tag IDs to apply. | |
| dueDate | No | Due date as ISO-8601 with offset. | |
| flagged | No | Flag the task. | |
| deferDate | No | Defer date as ISO-8601 with offset. | |
| projectId | No | Project to add the task to. Omit for inbox or subtask. | |
| sequential | No | If true, subtasks must be completed in order. | |
| parentTaskId | No | Parent task ID for a subtask. Omit for inbox or project task. | |
| dueDateFloating | No | When true, the due time follows the user across time zones (floating) rather than being pinned to a fixed UTC instant. Use for recurring daily tasks where '9 AM' should mean 9 AM wherever the user is. Default: false (fixed-offset). | |
| idempotency_key | No | Idempotency key for retry-safe creates. Identical subsequent calls within the TTL window replay the original envelope with meta.idempotentReplay = true instead of creating a duplicate task. | |
| estimatedMinutes | No | Estimated duration in minutes. | |
| deferDateFloating | No | When true, the defer time is floating (follows the user across time zones). | |
| completedByChildren | No | Complete when all subtasks complete. |