Microsoft To Do

Mark a Microsoft To Do task as completed. Convenience wrapper that always PATCHes status='completed'; the server auto-sets completedDateTime. Use Update Task to reopen a task (status='notStarted') or to change other fields.

Add a checklist item (subtask) to a Microsoft To Do task. Only display_name is required; the created item is returned with a GUID id, displayName, isChecked, and createdDateTime.

Create a task in a Microsoft To Do task list. Only title is required. Dates are passed as flat ISO-8601 strings plus a shared timezone; the tool builds the Graph dateTimeTimeZone objects. Notes are passed as body_content (+ body_content_type). NOTE: To Do treats due dates as whole days — the time component of due_date_time is normalized to midnight on save.

Create a new Microsoft To Do task list.

Delete a checklist item (subtask) from a Microsoft To Do task. This permanently removes the checklist item (this cannot be undone).

Delete a task from a Microsoft To Do task list. WARNING: this also permanently removes the task's checklist items and linked resources.

Permanently delete a file attachment from a Microsoft To Do task. This cannot be undone.

Delete a Microsoft To Do task list. WARNING: this cascades — all tasks in the list and their checklist items are permanently deleted.

Download one file attached to a Microsoft To Do task. The file is offloaded to storage and returned as a downloadable reference rather than inline base64.

Get a single Microsoft To Do checklist item (subtask) by its id, within a task in a task list.

Return the profile of the Microsoft account connected to this toolkit (whoami / connection verification). Useful to confirm which mailbox the To Do tasks belong to before other operations.

Get a single Microsoft To Do task by its id, within a task list. Set include_checklist_items=true to expand its checklist items inline.

Get metadata for one file attached to a Microsoft To Do task. Use Download Task Attachment to retrieve the file contents.

Get a single Microsoft To Do task list by its id.

List the checklist items (subtasks) of a To Do task. Auto-paginates so all subtasks are returned at once as {items: [...]}.

List the files attached to a Microsoft To Do task. Returns attachment metadata without file contents, one page at a time, plus a next_cursor.

List the To Do task lists owned by the connected user. The built-in default list has wellknown_list_name='defaultList'; user-created lists have wellknown_list_name='none'. Always returns at least the default list. Select the default list by id or wellknown_list_name, never by the localized display_name.

List the tasks in a To Do task list. Checklist items (subtasks) are NOT returned by default; set include_checklist_items=true to expand them inline. Returns one page of tasks plus a next_cursor for the next page.

Update a checklist item (subtask) of a Microsoft To Do task: rename it (display_name) and/or check/uncheck it (is_checked). Partial update: only the fields you pass are changed; at least one is required. Setting is_checked=true marks the subtask done.

Update fields of an existing Microsoft To Do task (title, notes, importance, status, due/start/reminder dates, categories). Partial update: only the fields you pass are changed; unset fields are left untouched. To mark a task done set status='completed' (or use the dedicated Complete Task tool).

Rename a Microsoft To Do task list (updates its displayName).

Attach a file up to 25 MB to a Microsoft To Do task. The tool automatically uses a single request for files under 3 MB and a chunked upload session for larger files.