m365-calendar

name	m365-calendar
version	0.1.0
description	Microsoft 365 Calendar: Create, read, update, and delete events; RSVP to invitations; access shared calendars.
metadata	{"openclaw":{"category":"productivity","requires":{"bins":["m365"],"skills":["m365-shared"]},"cliHelp":"m365 calendar --help"}}

m365-calendar — Calendar Operations

Prerequisites

Complete auth setup from m365-shared SKILL.md. Calendar commands require delegated auth with Calendar permissions:

m365 auth login

Required app permissions (delegated):

• Calendars.ReadWrite — read and manage your calendar
• Calendars.ReadWrite.Shared — access shared/other users' calendars (requires --user flag)

---

Command Reference

List calendars

m365 calendar list [--user <email|id>]

m365 calendar list
m365 calendar list --user [e-mail]

Output: array of Calendar objects with id, name, color, isDefaultCalendar, canEdit.

Get a calendar

m365 calendar get <calendarId> [--user <email|id>]

m365 calendar get AAMkAGI2...

---

List events

m365 calendar events list [--calendar <id>] [--filter <odata>] [--select <fields>] [--top <n>] [--user <email|id>]

m365 calendar events list --top 10
m365 calendar events list --calendar AAMkAGI2... --top 5
m365 calendar events list --filter "showAs eq 'busy'"
m365 calendar events list --select "id,subject,start,end,location"
m365 calendar events list --user [e-mail] --top 5

View events in a date range

m365 calendar events view --start <datetime> --end <datetime> [--calendar <id>] [--user <email|id>]

# Current week
m365 calendar events view --start 2026-03-06T00:00:00 --end 2026-03-13T00:00:00

# With timezone context (ISO datetime)
m365 calendar events view --start "2026-03-10T00:00:00" --end "2026-03-11T00:00:00"

Uses calendarView endpoint — returns expanded recurring instances within the range.

Get an event

m365 calendar events get <eventId> [--user <email|id>]

m365 calendar events get AAMkAGI2...

---

Create an event

m365 calendar events create \
  --subject <str> --start <datetime> --end <datetime> \
  [--timezone <tz>] [--all-day] \
  [--body <str>] [--html] \
  [--location <str>] \
  [--attendees <csv>] [--attendee-type required|optional] \
  [--show-as free|tentative|busy|oof|workingElsewhere] \
  [--reminder <minutes>] [--no-reminder] \
  [--online-meeting] \
  [--importance low|normal|high] \
  [--sensitivity normal|personal|private|confidential] \
  [--recurrence daily|weekly|monthly|yearly] \
  [--recur-interval <n>] [--recur-days <csv>] \
  [--recur-end <date> | --recur-count <n>] \
  [--calendar <id>] [--user <email|id>]

Required for create: --subject, --start, --end

Examples:

# Simple 30-minute meeting
m365 calendar events create \
  --subject "Sync with Alice" \
  --start 2026-03-10T10:00:00 \
  --end 2026-03-10T10:30:00 \
  --timezone "Eastern Standard Time"

# Full-featured meeting
m365 calendar events create \
  --subject "Quarterly review" \
  --start 2026-03-15T14:00:00 \
  --end 2026-03-15T15:00:00 \
  --timezone "Pacific Standard Time" \
  --attendees "[e-mail],[e-mail]" \
  --location "Conference Room A" \
  --body "Please review the Q1 report before this meeting." \
  --show-as busy \
  --reminder 15 \
  --online-meeting

# All-day event
m365 calendar events create \
  --subject "Company Holiday" \
  --start 2026-03-17T00:00:00 \
  --end 2026-03-17T00:00:00 \
  --all-day \
  --show-as free

# Weekly recurring (Mon/Wed/Fri for 8 occurrences)
m365 calendar events create \
  --subject "Daily standup" \
  --start 2026-03-09T09:00:00 \
  --end 2026-03-09T09:15:00 \
  --timezone "Eastern Standard Time" \
  --recurrence weekly \
  --recur-days mon,wed,fri \
  --recur-count 8

Update an event

m365 calendar events update <eventId> [same flags as create, all optional]

# Change subject and add a reminder
m365 calendar events update AAMkAGI2... \
  --subject "Updated: Quarterly review" \
  --reminder 30

# Move time slot
m365 calendar events update AAMkAGI2... \
  --start 2026-03-15T15:00:00 \
  --end 2026-03-15T16:00:00

# Disable reminder
m365 calendar events update AAMkAGI2... --no-reminder

Delete an event

m365 calendar events delete <eventId> [--user <email|id>]

m365 calendar events delete AAMkAGI2...

---

RSVP to invitations

# Accept
m365 calendar events accept <eventId> [--comment <str>] [--user <email|id>]

# Decline
m365 calendar events decline <eventId> [--comment <str>] [--user <email|id>]

# Tentative
m365 calendar events tentative <eventId> [--comment <str>] [--user <email|id>]

Examples:

m365 calendar events accept AAMkAGI2...
m365 calendar events decline AAMkAGI2... --comment "Conflict with another meeting"
m365 calendar events tentative AAMkAGI2... --comment "Will try to join"

All RSVP commands send the response to the organizer (sendResponse: true).

---

Shared Calendar Access

Use --user <email|upn> on any calendar command to access another user's calendar (requires Calendars.ReadWrite.Shared and appropriate calendar sharing settings):

# View colleague's upcoming events
m365 calendar events view \
  --start 2026-03-06T00:00:00 --end 2026-03-13T00:00:00 \
  --user [e-mail]

# List colleague's calendars
m365 calendar list --user [e-mail]

# Create event on colleague's calendar
m365 calendar events create \
  --subject "Meeting" --start 2026-03-10T10:00:00 --end 2026-03-10T10:30:00 \
  --user [e-mail]

---

Event Flags Reference

Flag	Description	Default
--subject <str>	Event title	required (create)
--start <datetime>	Start (ISO8601)	required (create)
--end <datetime>	End (ISO8601)	required (create)
--timezone <tz>	Windows timezone name	UTC
--all-day	All-day event	off
--body <str>	Description/body text
--html	Body is HTML	plain text
--location <str>	Location display name
--attendees <csv>	Comma-separated email addresses
--attendee-type	required or optional	required
--show-as	free, tentative, busy, oof, workingElsewhere
--reminder <n>	Enable reminder N minutes before
--no-reminder	Disable reminder
--online-meeting	Add Teams meeting link	off
--importance	low, normal, high
--sensitivity	normal, personal, private, confidential
--recurrence	daily, weekly, monthly, yearly
--recur-interval <n>	Every N periods	1
--recur-days <csv>	Days: mon,tue,wed,thu,fri,sat,sun
--recur-end <date>	Recurrence end date (ISO date)
--recur-count <n>	Number of occurrences	(no end)
--calendar <id>	Specific calendar	default calendar
--user <email|id>	Shared calendar user	signed-in user

Timezone names use Windows format (not IANA): "Eastern Standard Time", "Pacific Standard Time", "UTC", "GMT Standard Time", etc.

---

Common Patterns

Get this week's schedule

m365 calendar events view \
  --start "$(date -u +%Y-%m-%dT00:00:00)" \
  --end "$(date -u -d '+7 days' +%Y-%m-%dT00:00:00)" \
  | jq '.data[] | {subject, start: .start.dateTime, end: .end.dateTime}'

Create and confirm an event

event_id=$(m365 calendar events create \
  --subject "Test" --start 2026-03-10T10:00:00 --end 2026-03-10T10:30:00 \
  | jq -r '.data.id')
m365 calendar events get "$event_id" | jq '.data | {id, subject, start}'

Accept all pending invitations

m365 calendar events list \
  --filter "responseStatus/response eq 'notResponded'" \
  --select "id,subject" \
  | jq -r '.data[].id' | xargs -I{} m365 calendar events accept {}

Delete an event after confirming it

m365 calendar events get AAMkAGI2... | jq '.data | {subject, start}'
m365 calendar events delete AAMkAGI2...

---

API Resources

• GET /me/calendars — list calendars
• GET /me/calendars/{id} — get calendar
• GET /me/calendar/events — list events (default calendar)
• GET /me/calendarView?startDateTime=...&endDateTime=... — date-range view
• GET /me/events/{id} — get event
• POST /me/calendar/events — create event
• PATCH /me/events/{id} — update event
• DELETE /me/events/{id} — delete event
• POST /me/events/{id}/accept — accept invitation
• POST /me/events/{id}/decline — decline invitation
• POST /me/events/{id}/tentativelyAccept — tentative accept
• Replace /me with /users/{email} for shared calendar access

---

Discovering Commands

m365 calendar --help
m365 calendar events --help
m365 calendar events create --help
m365 calendar events view --help