Create Task
omnifocus_create_taskAdd tasks to OmniFocus with due dates, tags, and recurrence patterns for repeat tasks.
Instructions
Create a new task in OmniFocus.
Creates a task in the inbox or a specific project. Tags, due dates, planned dates and other properties can be set. Supports repeating/recurring tasks.
Args:
name (string): Task name/title (required)
note (string): Optional note/description
projectName (string): Project to add to (inbox if not specified)
parentTaskId (string): ID of a parent task to create this as a subtask of (takes priority over projectName)
dueDate (string): Due date in ISO 8601 format - when the task must be completed
deferDate (string): Defer/start date in ISO 8601 format
plannedDate (string): Planned date in ISO 8601 format - when you intend to work on the task
flagged (boolean): Flag the task (default: false)
estimatedMinutes (number): Time estimate in minutes
tagNames (array): Tag names to apply
recurrence (object): Optional recurrence pattern with:
frequency: "daily", "weekly", "monthly", or "yearly"
interval: Number of periods between repetitions (default: 1)
daysOfWeek: Array of days for weekly recurrence (e.g., ["Monday", "Friday"])
dayOfMonth: Day number for monthly recurrence (1-31)
monthOfYear: Month number for yearly recurrence (1-12)
repeatFrom: "due-date" or "completion-date" (default: "due-date")
Returns: The created task object with id, name, and other properties
Examples:
Simple task: { name: "Buy groceries" }
Task with details: { name: "Review report", projectName: "Work", dueDate: "2024-12-31T17:00:00", flagged: true }
Daily recurring: { name: "Daily standup", dueDate: "2024-01-01T09:00:00", recurrence: { frequency: "daily", interval: 1 } }
Weekly on Mon/Wed/Fri: { name: "Workout", dueDate: "2024-01-01T07:00:00", recurrence: { frequency: "weekly", daysOfWeek: ["Monday", "Wednesday", "Friday"] } }
Monthly on 1st and 15th: { name: "Pay bills", dueDate: "2024-01-01T12:00:00", recurrence: { frequency: "monthly", interval: 1, dayOfMonth: 1 } }
Repeat from completion: { name: "Review quarterly", recurrence: { frequency: "monthly", interval: 3, repeatFrom: "completion-date" } }
Task with planning: { name: "Write article", plannedDate: "2024-12-15T09:00:00", dueDate: "2024-12-31T17:00:00" }
Task with tags: { name: "Call John", tagNames: ["Calls", "Urgent"] }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The task name/title | |
| note | No | Optional note/description for the task | |
| dueDate | No | Due date in ISO 8601 format (e.g., '2024-12-31T17:00:00') | |
| flagged | No | Whether to flag the task | |
| tagNames | No | Array of tag names to apply | |
| deferDate | No | Defer/start date in ISO 8601 format | |
| recurrence | No | Recurrence pattern for repeating tasks | |
| plannedDate | No | Planned date in ISO 8601 format - when you intend to work on the task | |
| projectName | No | Name of project to add task to (creates in inbox if not specified) | |
| parentTaskId | No | ID of parent task to create this as a subtask (makes this task a child of the parent) | |
| estimatedMinutes | No | Estimated time in minutes |