Update Project
omnifocus_update_projectUpdate an existing OmniFocus project's name, status, dates, notes, or review interval. Change status to active, on hold, done, or dropped; clear dates or notes by passing null.
Instructions
Update properties of an existing project in OmniFocus.
Only the fields you provide are changed. Use null to clear a date or note field.
Args:
projectId (string, optional): The project's ID. Takes priority if both projectId and projectName provided.
projectName (string, optional): The project's name to search for. At least one of projectId or projectName is required.
name (string, optional): New project name
note (string | null, optional): New note text. Pass null to clear.
status (string, optional): "active", "on hold", "done", or "dropped". Setting "done" completes the project and "dropped" drops it (setting "active" reactivates a completed/dropped project).
flagged (boolean, optional): Set flagged state
dueDate (string | null, optional): New due date in ISO 8601 format. Pass null to clear.
deferDate (string | null, optional): New defer date in ISO 8601 format. Pass null to clear.
sequential (boolean, optional): Tasks must be done in order (true) or parallel (false)
reviewIntervalDays (number, optional): Review interval in days (1-3650)
Note: moving a project between folders is not supported by OmniFocus's JXA layer (the move operation returns "Replacement not supported"). Recreate the project in the target folder if you need to move it.
Returns: The updated project object
Examples:
Rename: { projectId: "abc123", name: "New name" }
Put on hold: { projectId: "abc123", status: "on hold" }
Complete the project: { projectId: "abc123", status: "done" }
Drop the project: { projectId: "abc123", status: "dropped" }
Set review interval: { projectId: "abc123", reviewIntervalDays: 14 }
Clear due date: { projectId: "abc123", dueDate: null }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New project name | |
| note | No | New note text. Pass null to clear the note. | |
| status | No | New project status | |
| dueDate | No | New due date in ISO 8601 format. Pass null to clear. | |
| flagged | No | Set flagged state | |
| deferDate | No | New defer/start date in ISO 8601 format. Pass null to clear. | |
| projectId | No | The project ID to update. Takes priority if both projectId and projectName are provided. | |
| sequential | No | If true, tasks must be completed in order (sequential). If false, parallel. | |
| projectName | No | The project name to search for. At least one of projectId or projectName is required. | |
| reviewIntervalDays | No | Review interval in days. |