New command: `outlook event list`

[MartinM85]

Usage

m365 outlook event list [options]

Description

Retrieves a list of events from a specific calendar of a user

Options

Option	Description
--userId [userId]	ID of the user. Specify either userId or userName, but not both.
--userName [userName]	UPN of the user. Specify either userId or userName, but not both.
--calendarId [calendarId]	ID of the calendar. Specify either calendarId or calendarName, but not both.
--calendarName [calendarName]	Name of the calendar. Specify either calendarId or calendarName, but not both.
--startDateTime [startDateTime]	Start date of the events.
--endDateTime [endDateTime]	End date of the events.
--properties [properties]	Comma-separated list of properties to retrieve.
--filter [filter]	OData filter to apply when retrieving the events.

Examples

List all events for the current signed-in user from a calendar specified by id.

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ"

List only id, subject, start time and end time of all events for a specific user and specific calendar

m365 outlook event list --userName "john.doe@contoso.com" --calendarName "Calendar" --properties "id,subject,start,end"

Filter events for the current signed-in user

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --filter 'contains(subject, 'contoso')' `start/dateTime ge '2026-01-01' and end/dateTime le '2026-01-31'`

List all events from specific date range

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --startDateTime '2026-01-01' --endDateTime '2026-01-31'

Default properties

• id
• subject

Additional Info

API: https://learn.microsoft.com/en-us/graph/api/user-list-events?view=graph-rest-1.0&tabs=http

[milanholemans]

Nice spec @MartinM85, a few remarks from my side:

• I would include the start date in the default properties
• Could it be useful to expose the time zone parameter?
• I like the properties and filter parameters, but I tend to also include something like startDateTime and endDateTime. These parameters are generally used in list commands that can return a lot of content. It makes it easier for the user to specify a range of events they want to retrieve, making it easier for people who are not familiar with OData filter queries. In this case, the filter parameter would add extra filters to the filter query ($filter=<date range> and <filter>). What do you think?

[MartinM85]

@milanholemans Added the startDateTime and endDateTime options.

I'm fine with the timeZone option, but we should mention all supported time zones in the doc (or add link to https://learn.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0)

[milanholemans]

@milanholemans Added the startDateTime and endDateTime options.

I'm fine with the timeZone option, but we should mention all supported time zones in the doc (or add link to https://learn.microsoft.com/en-us/graph/api/resources/datetimetimezone?view=graph-rest-1.0)

I would just add the link to the doc. It's impossible for us to maintain the list ourselves.