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 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:

• Creating, 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

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