edit_item

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
`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"
}

OmniFocus-MCP

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from OmniFocus-MCP

Related Tools

MCP directory API