Get-MgUserToDoList

What is Get-MgUserToDoList?

Get-MgUserToDoList is a Microsoft Graph PowerShell cmdlet used to retrieve Microsoft To Do task lists associated with a specific user. These task lists act as containers for To Do tasks such as Tasks, Important, or any custom lists created by the user.

Why Use Get-MgUserToDoList?

This cmdlet is useful in automation and reporting scenarios where administrators or scripts need to:

• Discover all Microsoft To Do task lists for a user
• Identify list IDs before working with tasks
• Build task management or productivity reports
• Automate downstream actions using Get-MgUserTodoTask

It serves as the entry point for working with Microsoft To Do lists programmatically.

Prerequisites

Before running this cmdlet, connect to Microsoft Graph with the required permissions:

Connect-MgGraph -Scopes "Tasks.Read"

How to use Get-MgUserToDoList?

Basic syntax:

Get-MgUserToDoList [-UserId  <String>]

You can pass either the UserPrincipalName (UPN) or UserId to retrieve all Microsoft To Do task lists owned by the user.

Get-MgUserToDoList Examples

• Example 1: Get All Task Lists

To retrieve all task lists for a specific user, use the following command:

Get-MgUserToDoList -UserId "user@example.com"

This command returns all Microsoft To Do lists (default and custom) associated with the specified user.

• Example 2: Filtering Task Lists

To filter task lists based on specific criteria, such as lists that are not completed, use the -Filter parameter:

Get-MgUserToDoList -UserId "user@example.com" -Filter "status ne 'completed'"

This helps narrow down results when working with large numbers of task lists.

Summary

Key Point	Details
Cmdlet Name	Get-MgUserToDoList
Purpose	Retrieves Microsoft To Do task lists for a user
Required Scope	Tasks.Read
Target Resource	User To Do task lists
Common Use Case	Discover list IDs before retrieving or creating tasks
Automation Benefit	Enables structured task and productivity automation