task_create
Create a task in OmniFocus inbox, project, or as a subtask. Supports due dates, notes, tags, and flags.
Instructions
Create a new task in OmniFocus — in the inbox, inside a project, or as a subtask of another task. Supply exactly one of: projectId (project task), parentTaskId (subtask), or neither (inbox). Do not use for bulk creation; prefer task_batch_create for that. Safety control: pass idempotency_key to make transport retries safe — identical subsequent calls within the TTL window replay the original envelope with meta.idempotentReplay = true instead of creating a duplicate task. Returns { id, name } — name echoes the supplied name so the agent can describe the new task without a follow-up read. Side effects: creates a task in OmniFocus, sets meta.syncPending = true. Call sync_trigger when you need the task to appear on other devices. Example: task_create({ name: "Buy milk" }) Example: task_create({ name: "Write report", projectId: "prj123", dueDate: "2026-05-01T00:00:00Z" })
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. |