Get-MgUserTodoTask

What is Get-MgUserTodoTask?

Get-MgUserTodoTask is a Microsoft Graph PowerShell cmdlet used to retrieve Microsoft To Do tasks associated with a user. It allows administrators and scripts to fetch tasks either across all task lists or from a specific To Do list, along with detailed task properties such as due dates, status, and importance.

Why Use Get-MgUserTodoTask?

This cmdlet is ideal for automation and reporting scenarios, such as:

• Auditing user To Do tasks
• Monitoring overdue or high-priority tasks
• Building productivity or compliance reports
• Integrating Microsoft To Do data into external systems

It provides programmatic visibility into user task data without manual access to the To Do UI.

Prerequisites

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

Connect-MgGraph -Scopes "Tasks.Read"

How to use Get-MgUserTodoTask?

Basic syntax:

Get-MgUserTodoTask -UserId <String> [-TodoTaskListId <String>]

You can retrieve all tasks for a user or limit the output to tasks from a specific Microsoft To Do list by providing the -TodoTaskListId parameter.

Note: -TodoTaskListId can be got by running Get-MgUserToDoList cmdlet and passing the -UserID.

Get-MgUserTodoTask Examples

• Example 1: Retrieve All Tasks for a Specific User

This command retrieves all to-do tasks for the specified user.

Get-MgUserTodoTask -UserId "user@domain.com"

• Example 2: Retrieve Tasks from a Specific To-Do List

This command retrieves tasks from a specific to-do list for the specified user.

Get-MgUserTodoTask -UserId "user@domain.com" -TodoTaskListId "AAMkAGVmMDEzY2M2LTYyYmYtNGJkNC1hOTQyLWZkN2NiNWE4ZDQ1YQBGAAAAAABuvOM0dzGRQpWnUljGvYH2BwA3j2cyBh+8Ro7AAA="

• Example 3: Retrieve Tasks with Specific Properties

This command retrieves only selected task properties to reduce output size.

Get-MgUserTodoTask -UserId "user@domain.com" -Select "subject,dueDateTime"

Summary

Key Point	Details
Cmdlet Name	Get-MgUserTodoTask
Purpose	Retrieves Microsoft To Do tasks for a user
Required Scope	Tasks.Read
Target Resource	User To Do tasks
Supports Filtering	Yes (via list selection and property selection)
Automation Benefit	Enables task audits and productivity reporting