- Category: task management
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 25
- Triggers: 0
- Slug:
MICROSOFT_TODO - Version: 20261101_00
Tools
Complete Task
Complete Task
Create Checklist Item
Create Checklist Item
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
Text of the checklist item / subtask. Required — maps to the ‘displayName’ body field.
Output
Create Linked Resource
Create Linked Resource
Create Task
Create Task
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
Task status: ‘notStarted’, ‘inProgress’, ‘completed’, ‘waitingOnOthers’, or ‘deferred’. Defaults server-side to ‘notStarted’.
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.
Task importance: ‘low’, ‘normal’, or ‘high’. Defaults server-side to ‘normal’.
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).
Start date as an ISO-8601 local datetime; combined with time_zone into the Graph startDateTime object.
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.
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
Create Task List
Create Task List
Delete Checklist Item
Delete Checklist Item
Delete Task
Delete Task
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
Id of the task to delete. Deleting a task permanently removes its checklist items and linked resources (this cannot be undone).
Output
Delete Task Attachment
Delete Task Attachment
Delete Task List
Delete Task List
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
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
Download Task Attachment
Download Task Attachment
Get Checklist Item
Get Checklist Item
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
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.
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.
Id (GUID) of the checklist item to fetch (path param checklistItemId). This is the GUID returned by the list/create checklist-item actions.
Output
Get Current User
Get Current User
Get Task
Get Task
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
Advanced OData $expand expression. Normally leave unset and use include_checklist_items instead.
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.
Id of the task to fetch (path param taskId). This is the long URL-safe id returned by the list/create task actions.
When true, request the task’s checklist items (subtasks) inline. When false, the tool does not send a $expand query.
Output
Get Task Attachment
Get Task Attachment
Get Task List
Get Task List
List Checklist Items
List Checklist Items
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
Id of the task list that owns the task (path param todoTaskListId). Get one from MICROSOFT_TODO_LIST_TASK_LISTS.
Id of the task whose checklist items (subtasks) to return (path param taskId). Get one from MICROSOFT_TODO_LIST_TASKS.
Output
List Linked Resources
List Linked Resources
List Task Attachments
List Task Attachments
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
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back unchanged to fetch the next page.
Output
List Task Lists
List Task Lists
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
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.
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back to fetch the next page.
Output
List Tasks
List Tasks
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
Max tasks to return per page (maps to OData $top). The server may cap this. If omitted the server uses its default page size.
Pagination token from a previous call’s next_cursor. Omit for the first page; pass it back to fetch the next page.
Advanced OData $expand expression. Normally leave unset and use include_checklist_items instead; that derives $expand=checklistItems.
Optional OData $filter expression, e.g. “status eq ‘notStarted’” or “importance eq ‘high’”. Advanced; omit to return all tasks.
Id of the task list whose tasks to return (path param todoTaskListId). Get one from MICROSOFT_TODO_LIST_TASK_LISTS.
When true, expand each task’s checklist items (subtasks) inline (maps to OData $expand=checklistItems). Default false.
Output
Sync Task Lists
Sync Task Lists
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
Opaque continuation cursor returned by the previous page in the current synchronization round. Pass it back unchanged.
Comma-separated OData fields to select on the initial request. This selection is retained by continuation cursors.
Checkpoint returned after an earlier synchronization round completed. Omit when starting the first round.
Output
Update Checklist Item
Update Checklist Item
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
Set true to check off the subtask (mark it done), false to uncheck it. Checking auto-populates checkedDateTime server-side.
New text for the checklist item (maps to displayName). Replaces the existing text when provided.
Output
Update Task
Update Task
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
Task status: ‘notStarted’, ‘inProgress’, ‘completed’, ‘waitingOnOthers’, or ‘deferred’. Setting ‘completed’ auto-populates completedDateTime server-side.
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.
New notes/description for the task (maps to body.content). Replaces the existing notes when provided.
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.
New start date as an ISO-8601 local datetime; combined with time_zone into the startDateTime object. Pass null to clear it.
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.
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
Update Task List
Update Task List
Upload Task Attachment
Upload Task Attachment
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
File to attach. Files under 3 MB use a single request; larger files up to 25 MB use a chunked upload session automatically.