edit_item
Modify tasks or projects in OmniFocus by updating names, notes, due dates, tags, status, and more. Supports editing via ID or name for flexibility.
Instructions
Edit a task or project in OmniFocus
Input Schema
Name | Required | Description | Default |
---|---|---|---|
addTags | No | Tags to add to the task | |
id | No | The ID of the task or project to edit | |
itemType | Yes | Type of item to edit ('task' or 'project') | |
name | No | The name of the task or project to edit (as fallback if ID not provided) | |
newDeferDate | No | New defer date in ISO format (YYYY-MM-DD or full ISO date); set to empty string to clear | |
newDueDate | No | New due date in ISO format (YYYY-MM-DD or full ISO date); set to empty string to clear | |
newEstimatedMinutes | No | New estimated minutes | |
newFlagged | No | Set flagged status (set to false for no flag, true for flag) | |
newFolderName | No | New folder to move the project to | |
newName | No | New name for the item | |
newNote | No | New note for the item | |
newProjectStatus | No | New status for projects | |
newSequential | No | Whether the project should be sequential | |
newStatus | No | New status for tasks (incomplete, completed, dropped) | |
removeTags | No | Tags to remove from the task | |
replaceTags | No | Tags to replace all existing tags with |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"addTags": {
"description": "Tags to add to the task",
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "The ID of the task or project to edit",
"type": "string"
},
"itemType": {
"description": "Type of item to edit ('task' or 'project')",
"enum": [
"task",
"project"
],
"type": "string"
},
"name": {
"description": "The name of the task or project to edit (as fallback if ID not provided)",
"type": "string"
},
"newDeferDate": {
"description": "New defer date in ISO format (YYYY-MM-DD or full ISO date); set to empty string to clear",
"type": "string"
},
"newDueDate": {
"description": "New due date in ISO format (YYYY-MM-DD or full ISO date); set to empty string to clear",
"type": "string"
},
"newEstimatedMinutes": {
"description": "New estimated minutes",
"type": "number"
},
"newFlagged": {
"description": "Set flagged status (set to false for no flag, true for flag)",
"type": "boolean"
},
"newFolderName": {
"description": "New folder to move the project to",
"type": "string"
},
"newName": {
"description": "New name for the item",
"type": "string"
},
"newNote": {
"description": "New note for the item",
"type": "string"
},
"newProjectStatus": {
"description": "New status for projects",
"enum": [
"active",
"completed",
"dropped",
"onHold"
],
"type": "string"
},
"newSequential": {
"description": "Whether the project should be sequential",
"type": "boolean"
},
"newStatus": {
"description": "New status for tasks (incomplete, completed, dropped)",
"enum": [
"incomplete",
"completed",
"dropped"
],
"type": "string"
},
"removeTags": {
"description": "Tags to remove from the task",
"items": {
"type": "string"
},
"type": "array"
},
"replaceTags": {
"description": "Tags to replace all existing tags with",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"itemType"
],
"type": "object"
}