Skip to content
All tools

todo_create_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

Creates a task in Microsoft To Do (via Reminders sync). Task appears in To Do automatically once synced. The answer names the list and the account it used. When the list name exists in several accounts it refuses and lists them: pass `account`, or `list` as "Account/List".

Required inputs

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": {
    "account": {
      "description": "Account that owns the list (from todo_get_folders), to tell apart lists with the same name. Optional.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "due_date": {
      "description": "Due date (YYYY-MM-DD, optional)",
      "type": "string"
    },
    "list": {
      "description": "List name (from todo_get_folders), or \"Account/List\". Defaults to the first available list.",
      "type": "string"
    },
    "notes": {
      "description": "Task notes (optional)",
      "type": "string"
    },
    "priority": {
      "description": "Priority: 1=high, 5=medium, 9=low (optional)",
      "type": "integer"
    },
    "title": {
      "description": "Task title",
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "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

Creates a task in Microsoft To Do / Outlook Tasks.

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": {
    "body": {
      "description": "Task notes (optional)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "due_date": {
      "description": "Due date (YYYY-MM-DD, optional)",
      "type": "string"
    },
    "notes": {
      "description": "Alias for `body` — the name the cloud catalog (Mac) advertises.",
      "type": "string"
    },
    "subject": {
      "description": "Task title",
      "type": "string"
    },
    "title": {
      "description": "Alias for `subject` — the name the cloud catalog (Mac) advertises.",
      "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"
}