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]	Time indicating the inclusive start of a time range when the event starts.
--endDateTime [endDateTime]	Time indicating the exclusive end of a time range when the event starts.
--timeZone [timeZone]	The time zone for the event start and end times.
--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 all events for the current signed-in user from a calendar specified by id and return event times in Pacific Standard Time time zone.

m365 outlook event list --userId "@meId" --calendarId "AAMkAGRkZ" --timeZone 'Pacific Standard Time'

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')"

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

Remarks

When you specify a value for timeZone, consider the options of the time zone list, or additional time zone list

[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.

[MartinM85]

@milanholemans Spec updated

[milanholemans]

Added a small remark, apart from that, it looks good.