Skip to main content
Microsoft To Do logo
  • Category: task management
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 25
  • Triggers: 0
  • Slug: MICROSOFT_TODO
  • Version: 20261101_00

Tools

Slug: MICROSOFT_TODO_COMPLETE_TASKMark 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.

Input Parameters

string
required
Id of the task list that contains the task.
string
required
Id of the task to mark as completed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_CREATE_CHECKLIST_ITEMAdd a checklist item (subtask) to a Microsoft To Do task in a specified task list. The created item is returned with its ID, display name, checked state, and creation time.

Input Parameters

string
required
Id of the task list containing the task (path param todoTaskListId).
string
required
Id of the task to add the subtask to (path param taskId).
boolean
Whether the item starts checked (completed). Defaults server-side to false.
string
required
Text of the checklist item / subtask. Required — maps to the ‘displayName’ body field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_CREATE_LINKED_RESOURCEAttach a partner-application link to an existing Microsoft To Do task.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task to attach the linked resource to.
string
required
Deep link to the item in the source application.
string
required
Id of the item in the source application.
string
required
Title of the linked item.
string
required
Name of the source application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_CREATE_TASKCreate 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.

Input Parameters

string
required
Task title. Required — omitting it returns HTTP 400 ‘The property title is required’.
string ("notStarted" | "inProgress" | "completed" | "waitingOnOthers" | "deferred")
Task status: ‘notStarted’, ‘inProgress’, ‘completed’, ‘waitingOnOthers’, or ‘deferred’. Defaults server-side to ‘notStarted’.
string
required
Id of the task list to create the task in (path param todoTaskListId).
string
IANA/Windows timezone name applied to due_date_time, start_date_time, and reminder_date_time (e.g. ‘UTC’, ‘Pacific Standard Time’). Graph may normalize the returned dateTimeTimeZone to UTC rather than preserve this name.
array
List of category name strings to tag the task with.
string ("low" | "normal" | "high")
Task importance: ‘low’, ‘normal’, or ‘high’. Defaults server-side to ‘normal’.
string
Free-text notes/description for the task (maps to body.content).
string
Due date as an ISO-8601 local datetime, e.g. ‘2026-07-10T00:00:00’. Combined with time_zone into the Graph dueDateTime object. NOTE: To Do treats due dates as whole days — the time component is normalized to midnight on save (e.g. 17:00 becomes 00:00).
boolean
Whether a reminder is active. A provided reminder_date_time always activates it.
string
Start date as an ISO-8601 local datetime; combined with time_zone into the Graph startDateTime object.
string ("text" | "html")
Content type of body_content: ‘text’ or ‘html’ (maps to body.contentType). Only used when body_content is set. Microsoft To Do may normalize stored HTML to plain text and strip markup.
string
Reminder date/time as an ISO-8601 local datetime; combined with time_zone into the Graph reminderDateTime object. Providing this always activates the reminder.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_CREATE_TASK_LISTCreate a new Microsoft To Do task list.

Input Parameters

string
required
Name of the new task list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_DELETE_CHECKLIST_ITEMDelete a checklist item (subtask) from a Microsoft To Do task. This permanently removes the checklist item (this cannot be undone).

Input Parameters

string
required
Id of the task list that contains the task.
string
required
Id of the task that contains the checklist item.
string
required
Id (GUID) of the checklist item (subtask) to delete. This cannot be undone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_DELETE_TASKDelete a task from a Microsoft To Do task list. WARNING: this also permanently removes the task’s checklist items and linked resources.

Input Parameters

string
required
Id of the task list that contains the task to delete.
string
required
Id of the task to delete. Deleting a task permanently removes its checklist items and linked resources (this cannot be undone).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_DELETE_TASK_ATTACHMENTPermanently delete a file attachment from a Microsoft To Do task. This cannot be undone.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task containing the attachment.
string
required
Id of the file attachment to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_DELETE_TASK_LISTDelete a Microsoft To Do task list. WARNING: this cascades — all tasks in the list and their checklist items are permanently deleted.

Input Parameters

string
required
Id of the task list to delete. Deleting a list permanently removes all of its tasks and their checklist items (this cascade cannot be undone).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_DOWNLOAD_TASK_ATTACHMENTDownload 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.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task containing the attachment.
string
required
Id of the file attachment to download.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_GET_CHECKLIST_ITEMGet a single Microsoft To Do checklist item (subtask) by its id, within a task in a task list.

Input Parameters

string
required
Id of the To Do task list that contains the task (path param todoTaskListId). This is the long URL-safe id returned by the list/create task-list actions, not the display name.
string
required
Id of the task that owns the checklist item (path param taskId). This is the long URL-safe id returned by the list/create task actions.
string
required
Id (GUID) of the checklist item to fetch (path param checklistItemId). This is the GUID returned by the list/create checklist-item actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_GET_CURRENT_USERReturn 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.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_GET_TASKGet a single Microsoft To Do task by its id, within a task list. Set include_checklist_items=true to expand its checklist items inline.

Input Parameters

string
Advanced OData $expand expression. Normally leave unset and use include_checklist_items instead.
string
required
Id of the To Do task list that contains the task (path param todoTaskListId). This is the long URL-safe id returned by the list/create task-list actions, not the display name.
string
required
Id of the task to fetch (path param taskId). This is the long URL-safe id returned by the list/create task actions.
boolean
When true, request the task’s checklist items (subtasks) inline. When false, the tool does not send a $expand query.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_GET_TASK_ATTACHMENTGet metadata for one file attached to a Microsoft To Do task. Use Download Task Attachment to retrieve the file contents.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task containing the attachment.
string
required
Id of the file attachment to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_GET_TASK_LISTGet a single Microsoft To Do task list by its id.

Input Parameters

string
required
Id of the To Do task list to fetch. This is the long URL-safe id returned by the list/create task-list actions (e.g. the id field), not the display name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_LIST_CHECKLIST_ITEMSList the checklist items (subtasks) of a To Do task. Auto-paginates so all subtasks are returned at once as {items: […]}.

Input Parameters

string
required
Id of the task list that owns the task (path param todoTaskListId). Get one from MICROSOFT_TODO_LIST_TASK_LISTS.
string
required
Id of the task whose checklist items (subtasks) to return (path param taskId). Get one from MICROSOFT_TODO_LIST_TASKS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_LIST_LINKED_RESOURCESList external resources linked to a Microsoft To Do task. Auto-paginates the task’s small linked-resource collection and returns all items at once.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task whose linked resources to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_LIST_TASK_ATTACHMENTSList the files attached to a Microsoft To Do task. Returns attachment metadata without file contents, one page at a time, plus a next_cursor.

Input Parameters

string
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back unchanged to fetch the next page.
string
required
Id of the task list containing the task.
string
required
Id of the task whose file attachments to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_LIST_TASK_LISTSList the connected user’s To Do task lists, one page at a time. Identify the built-in default list by ID or wellknown_list_name=‘defaultList’ rather than its localized display name; user-created lists have wellknown_list_name=‘none’.

Input Parameters

integer
Max task lists to return per page (maps to OData $top). The server may cap this. If omitted the server uses its default page size.
string
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back to fetch the next page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_LIST_TASKSList 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.

Input Parameters

integer
Max tasks to return per page (maps to OData $top). The server may cap this. If omitted the server uses its default page size.
string
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back to fetch the next page.
string
Advanced OData $expand expression. Normally leave unset and use include_checklist_items instead; that derives $expand=checklistItems.
string
Optional OData $filter expression, e.g. “status eq ‘notStarted’” or “importance eq ‘high’”. Advanced; omit to return all tasks.
string
required
Id of the task list whose tasks to return (path param todoTaskListId). Get one from MICROSOFT_TODO_LIST_TASK_LISTS.
boolean
When true, expand each task’s checklist items (subtasks) inline (maps to OData $expand=checklistItems). Default false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_SYNC_TASK_LISTSRead one page of Microsoft To Do task-list changes. Continue the current round with next_cursor, or store the terminal delta_token to retrieve only changes from a later round. Removed task lists retain their removal marker.

Input Parameters

string
Opaque continuation cursor returned by the previous page in the current synchronization round. Pass it back unchanged.
string
Comma-separated OData fields to select on the initial request. This selection is retained by continuation cursors.
string
Checkpoint returned after an earlier synchronization round completed. Omit when starting the first round.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_UPDATE_CHECKLIST_ITEMUpdate 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.

Input Parameters

string
required
Id of the task list containing the task.
string
required
Id of the task that owns the checklist item.
boolean
Set true to check off the subtask (mark it done), false to uncheck it. Checking auto-populates checkedDateTime server-side.
string
New text for the checklist item (maps to displayName). Replaces the existing text when provided.
string
required
Id (GUID) of the checklist item (subtask) to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_UPDATE_TASKUpdate fields of an existing Microsoft To Do task, including title, notes, importance, status, dates, and categories; set status to completed to mark it done. Unspecified fields are omitted, except that providing a reminder date also enables the reminder.

Input Parameters

string
New task title.
string ("notStarted" | "inProgress" | "completed" | "waitingOnOthers" | "deferred")
Task status: ‘notStarted’, ‘inProgress’, ‘completed’, ‘waitingOnOthers’, or ‘deferred’. Setting ‘completed’ auto-populates completedDateTime server-side.
string
required
Id of the task list containing the task to update.
string
required
Id of the task to update.
string
IANA/Windows timezone name applied to any of the date fields provided (due_date_time, start_date_time, reminder_date_time). Defaults to ‘UTC’. Graph may normalize returned dateTimeTimeZone values to UTC rather than preserve this name.
array
Replacement list of category name strings to tag the task with.
string ("low" | "normal" | "high")
Task importance: ‘low’, ‘normal’, or ‘high’.
string
New notes/description for the task (maps to body.content). Replaces the existing notes when provided.
string
New due date as an ISO-8601 local datetime (e.g. ‘2026-07-10T00:00:00’). Combined with time_zone into the Graph dueDateTime object. Note: To Do treats due dates as whole days, so the time component is normalized to midnight on save. Pass null to clear it.
boolean
Whether a reminder is active. A provided reminder_date_time always activates it.
string
New start date as an ISO-8601 local datetime; combined with time_zone into the startDateTime object. Pass null to clear it.
string ("text" | "html")
Content type of body_content: ‘text’ or ‘html’ (maps to body.contentType). Only used when body_content is provided; defaults to ‘text’. Microsoft To Do may normalize stored HTML to plain text and strip markup.
string
New reminder date/time as an ISO-8601 local datetime; combined with time_zone into the reminderDateTime object. Providing this always activates the reminder. Pass null to clear it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_UPDATE_TASK_LISTRename a Microsoft To Do task list (updates its displayName).

Input Parameters

string
required
Id of the task list to update.
string
required
New name for the task list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MICROSOFT_TODO_UPLOAD_TASK_ATTACHMENTAttach 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.

Input Parameters

object
required
File to attach. Files under 3 MB use a single request; larger files up to 25 MB use a chunked upload session automatically.
string
required
Id of the task list containing the task.
string
required
Id of the task that should receive the file attachment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not