complete_omnifocus_task

macOS

Purpose

Marks an OmniFocus task as complete. Needs OmniFocus Pro. Prefer task_id from list_omnifocus_tasks or search_omnifocus_tasks. With task_name instead, the name must match exactly, and if several tasks share it only the first one found is completed. Called without confirm it returns a preview; pass confirm=true to complete. Returns the id and name of the task it completed, so you can tell the user which one it was.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

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.

{
  "properties": {
    "confirm": {
      "description": "Must be true to complete; called without it, returns a preview.",
      "type": "boolean"
    },
    "task_id": {
      "description": "Exact task id from list_omnifocus_tasks (preferred). Provide this OR task_name.",
      "type": "string"
    },
    "task_name": {
      "description": "Task title to match when you don't have the id.",
      "type": "string"
    }
  },
  "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,
  "task_id": "demo-task-001"
}