Microsoft To Do
Create and manage Microsoft To Do task lists and tasks
OAuth10 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
GET
microsoft_todo_list_task_lists
List the authenticated user's Microsoft To Do task lists
/me/todo/lists
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| top | integer | optional | Maximum number of results to return |
| filter | string | optional | Microsoft Graph OData filter expression |
| orderBy | string | optional | Microsoft Graph OData order-by expression |
| select | string | optional | Comma-separated fields to return |
| skipToken | string | optional | Opaque continuation token from a previous response |
GET
microsoft_todo_get_task_list
Get one Microsoft To Do task list
/me/todo/lists/{taskListId}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
POST
microsoft_todo_create_task_list
Create a custom Microsoft To Do task list
/me/todo/lists
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| displayName | string | required | Task-list name |
PATCH
microsoft_todo_update_task_list
Rename a writable Microsoft To Do task list
/me/todo/lists/{taskListId}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| displayName | string | required | New task-list name |
DELETE
microsoft_todo_delete_task_list
Delete a custom Microsoft To Do task list
/me/todo/lists/{taskListId}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
GET
microsoft_todo_list_tasks
List tasks in a Microsoft To Do task list
/me/todo/lists/{taskListId}/tasks
6 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| top | integer | optional | Maximum number of results to return |
| filter | string | optional | Microsoft Graph OData filter expression |
| orderBy | string | optional | Microsoft Graph OData order-by expression |
| select | string | optional | Comma-separated fields to return |
| skipToken | string | optional | Opaque continuation token from a previous response |
GET
microsoft_todo_get_task
Get one Microsoft To Do task
/me/todo/lists/{taskListId}/tasks/{taskId}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| taskId | string | required | Microsoft To Do task identifier |
POST
microsoft_todo_create_task
Create a task in a Microsoft To Do task list
/me/todo/lists/{taskListId}/tasks
10 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| title | string | required | Task title |
| body | object | optional | Task notes body |
| importance | string | optional | Task importance |
| status | string | optional | Task workflow status; use completed to complete and notStarted to reopen |
| dueDateTime | object | optional | Due date and Windows/IANA-compatible time-zone context |
| reminderDateTime | object | optional | Reminder date and time-zone context |
| isReminderOn | boolean | optional | Whether the task reminder is enabled |
| recurrence | object | optional | Microsoft Graph patternedRecurrence object |
| categories | array | optional | Outlook category names assigned to the task |
PATCH
microsoft_todo_update_task
Edit, complete, or reopen a Microsoft To Do task
/me/todo/lists/{taskListId}/tasks/{taskId}
11 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| taskId | string | required | Microsoft To Do task identifier |
| title | string | optional | Task title |
| body | object | optional | Task notes body |
| importance | string | optional | Task importance |
| status | string | optional | Task workflow status; use completed to complete and notStarted to reopen |
| dueDateTime | object | optional | Due date and Windows/IANA-compatible time-zone context |
| reminderDateTime | object | optional | Reminder date and time-zone context |
| isReminderOn | boolean | optional | Whether the task reminder is enabled |
| recurrence | object | optional | Microsoft Graph patternedRecurrence object |
| categories | array | optional | Outlook category names assigned to the task |
DELETE
microsoft_todo_delete_task
Delete a Microsoft To Do task
/me/todo/lists/{taskListId}/tasks/{taskId}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| taskListId | string | required | Microsoft To Do task-list identifier |
| taskId | string | required | Microsoft To Do task identifier |