todo_list_tasks

Reminders & Microsoft To Do · macOS · Windows

Effect: read (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

Lists tasks from a Microsoft To Do list (or any Reminders list). Syncs via macOS Reminders. The answer names the account(s) it read (accounts_used, and `account` on each task). When the list name exists in several accounts it refuses and lists them: pass `account`, or `list` as "Account/List".

Required inputs

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

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real 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": {
    "account": {
      "description": "Account that owns the list (from todo_get_folders), to tell apart lists with the same name. Optional.",
      "type": "string"
    },
    "include_completed": {
      "description": "Include completed tasks (default false)",
      "type": "boolean"
    },
    "limit": {
      "description": "Max tasks to return (default 50)",
      "type": "integer"
    },
    "list": {
      "description": "List name (from todo_get_folders), or \"Account/List\". Leave empty to show all.",
      "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.

{
  "limit": 5
}

Windows

Purpose

Lists tasks from Microsoft To Do / Outlook Tasks on Windows, across the default task folder and every subfolder beneath it (up to 8 levels deep). Scans at most 500 items per call and says so when it stops early. The answer carries task_count (the tasks in the requested scope, completed ones included) and folder_count (the number of task folders in that scope; kept under that name for compatibility, it is NOT the task count), plus completed_hidden when completed tasks were left out.

Required inputs

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

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real 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 — Windows

{
  "properties": {
    "folder": {
      "description": "Task list or folder to read, by name or by full path as reported by todo_list_lists (default: every task folder, including subfolders). Use the full path when two folders share a name.",
      "type": "string"
    },
    "include_completed": {
      "description": "Include completed tasks (default: false)",
      "type": "boolean"
    }
  },
  "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.

{}