Skip to content
All tools

todo_complete_task

Reminders & Microsoft To Do · macOS · Windows

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

Marks a Microsoft To Do task as complete. It works through Apple Reminders, which syncs with To Do when the Microsoft account is added to Reminders, so the change appears in To Do after the next sync. Prefer task_id from todo_list_tasks. With `title` instead, it completes the FIRST open task whose title contains that text (case-insensitive): if several match, only one is completed and nothing warns you, and without `list` it searches every Reminders list, not only the To Do ones. Called without confirm it returns a preview; pass confirm=true to complete.

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.

Full input schema — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "List name to narrow search by title (optional)",
      "type": "string"
    },
    "task_id": {
      "description": "Task ID from todo_list_tasks",
      "type": "string"
    },
    "title": {
      "description": "Task title (partial match, alternative to task_id)",
      "type": "string"
    }
  },
  "required": [],
  "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,
  "title": "Planning meeting"
}

Windows

Purpose

Marks one task as complete in Microsoft To Do / Outlook Tasks, through the Outlook desktop app; Windows only. Without confirm=true nothing changes: the call returns a preview that echoes the subject and the list and does not look the task up, so it does not say whether the task exists. With confirm=true it looks for the task whose subject equals `subject` (no partial match, no task ID) and sets it complete at 100%. Without `list` it looks only in the root Tasks folder, not in its subfolders; with `list`, a name or full path from todo_list_tasks, it looks only there, and a list that is unknown or matches several folders is refused with an error. When several tasks in that folder share the subject, the first one Outlook returns is completed without warning, and it can be one that was already complete. A missing task returns 'not found', and a reply from Outlook that does not confirm the change is an error, never a success. The task is not deleted; this server has no tool to reopen it.

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.

Full input schema — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete",
      "type": "boolean"
    },
    "list": {
      "description": "Task list or folder to complete the task in, by name or full path as reported by todo_list_tasks (default: only the root Tasks folder). Disambiguates when the same subject exists in more than one list. The name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task subject (exact match)",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises. Exact match here, unlike the Mac tool's partial match.",
      "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,
  "title": "Planning meeting"
}