Microsoft To Do for AI agents
Agents read Microsoft To Do at once. Changes and sends are held for a person's approval by default.
About Microsoft To Do
Microsoft To Do is a cloud-based task management application that lets users create, organize, and track task lists, tasks, checklist items, and reminders across devices via Microsoft Graph
What an agent can do in Microsoft To Do
Every Microsoft To Do action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Microsoft To Do without asking first. 12 actions.
- 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.
- Get Checklist ItemGet a single Microsoft To Do checklist item (subtask) by its id, within a task in a task list.
- 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.
- 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.
- Get Task AttachmentGet metadata for one file attached to a Microsoft To Do task. Use Download Task Attachment to retrieve the file contents.
- Get Task ListGet a single Microsoft To Do task list by its id.
- List Checklist ItemsList the checklist items (subtasks) of a To Do task. Auto-paginates so all subtasks are returned at once as {items: [...]}.
- 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.
- 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.
- List Task ListsList 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
- 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 th
- 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 retai
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 13 actions.
- 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
- Create Checklist ItemAdd 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 Linked ResourceAttach a partner-application link to an existing Microsoft To Do task.
- 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 pa
- Create Task ListCreate a new Microsoft To Do task list.
- Delete Checklist ItemDelete a checklist item (subtask) from a Microsoft To Do task. This permanently removes the checklist item (this cannot be undone).
- Delete TaskDelete a task from a Microsoft To Do task list. WARNING: this also permanently removes the task's checklist items and linked resources.
- Delete Task AttachmentPermanently delete a file attachment from a Microsoft To Do task. This cannot be undone.
- Delete Task ListDelete a Microsoft To Do task list. WARNING: this cascades — all tasks in the list and their checklist items are permanently deleted.
- 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 requir
- Update TaskUpdate 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
- Update Task ListRename a Microsoft To Do task list (updates its displayName).
Show all 13
- 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.
Changes wait in Needs you
Changes and sends in Microsoft To Do are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Microsoft To Do questions
Can an agent change data in Microsoft To Do on its own?
Not by default. Changes and sends in Microsoft To Do are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Microsoft To Do?
This connector lists 12 read actions. Reads run at once, without waiting for approval.
How does Microsoft To Do connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.