Microsoft To Do

Read, create, update, and complete tasks and task lists in Microsoft To Do

The Microsoft To Do tool connects your assistant to your personal task lists via Microsoft Graph. You can read lists and tasks, create new tasks with due dates, reminders, and priority, complete or reopen tasks, manage checklist items (subtasks), and delete tasks - all through natural language.

Access runs in the user context (delegated): tool calls use the signed-in user's permissions and only see that user's own task lists.

When to Use

Ideal for:

  • Retrieving tasks from a list, filtered by status or due-date window
  • Creating new task lists
  • Creating tasks with a note, due date, reminder, and priority
  • Completing, reopening, or editing tasks
  • Adding checklist items (subtasks) to a task and checking them off
  • Permanently deleting tasks

Not suited for:

  • Renaming or deleting entire task lists
  • Shared lists of other users you have no delegated access to
  • Creating recurrence rules, attachments, or linked resources

Requirements

  1. Microsoft 365 work or school account (personal Microsoft accounts are not supported)
  2. OAuth connection set up in meinGPT
  3. Permissions requested at connect time: read tasks (Tasks.Read) and, for write and delete actions, read/write tasks (Tasks.ReadWrite)

Setup

  1. Enable the tool: Select the Microsoft To Do tool in your assistant
  2. Authenticate: On first use you are redirected to Microsoft
  3. Choose an account: Select your work or school account
  4. Confirm permissions: Approve read and (for write actions) read/write access to your tasks
  5. Optional: set a default list in the tool settings so the assistant does not have to ask for a list on every task

Checking write permissions (create, update, delete)

The Microsoft permission from step 4 (Tasks.ReadWrite) defines what Microsoft allows in principle. Whether your assistant can actually perform write actions like creating, updating, or completing tasks is additionally controlled in two places:

  • Connector configuration: Microsoft To Do → gear icon → Functions tab. Methods are listed by their technical id (e.g. todo_create_task, todo_update_task, todo_add_checklist_item), not a translated name. Enable the needed methods in the Write group and save the assistant.
  • Settings → Tool Management (admin): The global method policy must be set to "Read & modify" or "Full access" (or, under "Per-tool settings," the specific method must be enabled individually) – with "Read only," write actions stay blocked for everyone in the organization, regardless of the assistant-level selection.

Deleting is gated separately: Permanently deleting a task is a method in the Dangerous group and stays blocked even under "Read & modify." To allow it, an admin must either set the global policy to "Full access" or, under "Per-tool settings," enable the delete method specifically for Microsoft To Do.

If either setting is missing, meinGPT still shows the connection as "active" - but the assistant editor then shows the hint "Some methods have been locked by the administrator," and the write action fails with an error in chat.

Available Features

List task lists

"Which To Do lists do I have?"
"Show my task lists"

List tasks

"Show the open tasks in my 'Work' list"
"Which tasks are due this week?"
"List completed tasks in 'Personal'"

You can filter by status (notStarted, inProgress, completed, waitingOnOthers, deferred) and by a due-date window.

Task details

"Show me the task details including subtasks"

Returns the task with its checklist items (subtasks) and linked resources.

Create and update tasks

"Create a task 'Send quote', due tomorrow at 5pm, high priority"
"Mark the task 'Send quote' as done"
"Reopen the task and move the due date to Friday"

Checklist items (subtasks)

"Add the subtask 'Check pricing' to the task"
"Check off the subtask 'Check pricing'"

Delete tasks

"Delete the task 'Old note'"

Deletion is permanent and cannot be undone.

Notes

  • Times: Due and reminder times consist of a local date/time plus a time zone (default: UTC). For relative phrasing such as "tomorrow", the assistant first resolves the current date and converts it to an explicit point in time.
  • Default list: When a default list is configured in the tool settings, you can omit the list in most requests.
  • Web links: Microsoft Graph does not return a direct web link for individual tasks. Tasks are still citable as sources.

Privacy and Security

  • Authentication uses OAuth 2.0; meinGPT stores no Microsoft credentials
  • Access is limited to the signed-in user's own task lists
  • Write and delete actions happen only on your explicit instruction
  • You can revoke the connection at any time in your Microsoft account settings
Was this page helpful?