create_omnifocus_task

OmniFocus · macOS

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Creates a new task in OmniFocus. Requires confirm=true to execute.

Required inputs

name — The task title.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to create; called without it, returns a preview.",
      "type": "boolean"
    },
    "defer_date": {
      "description": "Defer/start date, ISO 8601 — the task stays hidden until then.",
      "type": "string"
    },
    "due_date": {
      "description": "Due date, ISO 8601 (YYYY-MM-DD or full timestamp).",
      "type": "string"
    },
    "flagged": {
      "default": "false",
      "description": "Create the task flagged.",
      "type": "boolean"
    },
    "name": {
      "description": "The task title.",
      "type": "string"
    },
    "note": {
      "description": "Longer note/body for the task.",
      "type": "string"
    },
    "project": {
      "description": "Project to file the task under (name). Omit for the inbox.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "name": "Planning meeting"
}