Skip to main content

Context Sources

Outlook Calendar

Outlook Calendar

Connect Outlook Calendar to check availability and manage Microsoft 365 meetings.

What it can do​

  • List calendars and read events.
  • Check attendee availability.
  • Create, update, cancel, or delete events.
  • Accept, decline, or tentatively accept invitations.

Setup and security​

  • You sign in with your own Microsoft account. Nomic can reach only the calendars that account can see.
  • Tools that change data ask for approval before they run. The Approval column under Supported tools shows each tool's setting.
  • Updating an event's attendees replaces the whole attendee list. Canceling an event notifies attendees; deleting it does not.
  • Your Microsoft 365 administrator may need to approve Nomic before you can finish signing in. See Microsoft Graph permissions.
  • Outlook Calendar and Outlook Mail are separate sign-ins. Both are separate from the Outlook integration under Settings → Integrations.

To connect, see Add an MCP server.

Example requests​

  • "What's on my calendar for the week of the owner walkthrough?"
  • "Find a time next week when the architect, the superintendent, and I are all free for an hour."
  • "Create a punch walk on Friday at 9am with the subcontractor leads."
  • "Cancel Thursday's OAC meeting and let the attendees know."

Supported tools​

ToolActionApproval
get_meRead the signed-in Microsoft profile.Not required
list_calendarsList available calendars.Not required
list_eventsList events in a time range from a selected calendar.Not required
get_eventRead an event's details.Not required
get_scheduleCheck attendee availability and free/busy schedules.Not required
create_eventCreate an event.Required
update_eventChange an event; providing attendees replaces the attendee list.Required
cancel_eventCancel an event and notify attendees.Required
delete_eventDelete an event without sending a cancellation notice.Required
respond_to_eventAccept, decline, or tentatively accept an invitation.Required

Microsoft Graph permissions​

This section is for Microsoft 365 administrators reviewing Nomic in Microsoft Entra.

Outlook Calendar requests only delegated permissions. Nomic acts as the signed-in user and reaches only the calendars that user can see. It requests no application permissions.

PermissionTypeAdmin consentUsed for
offline_accessDelegatedNot requiredKeep the user signed in between sessions with a refresh token.
User.ReadDelegatedNot requiredRead the signed-in user's profile.
Calendars.ReadWriteDelegatedNot requiredRead calendars and availability, and manage events.

Microsoft does not require admin consent for these permissions, but your tenant's user consent settings may still require an administrator to approve Nomic.

Outlook Calendar, Outlook Mail, and Microsoft Teams sign in through the same Nomic app in Microsoft Entra. Each requests only its own permissions when a user signs in.

Graph API calls​

Every call goes to https://graph.microsoft.com/v1.0 and stays under /me. get_me uses User.Read; every other tool uses Calendars.ReadWrite.

ToolGraph API call
get_meGET /me
list_calendarsGET /me/calendars
list_eventsGET /me/calendarView
GET /me/calendars/{id}/calendarView
get_eventGET /me/events/{id}
get_schedulePOST /me/calendar/getSchedule
create_eventPOST /me/events
POST /me/calendars/{id}/events
update_eventPATCH /me/events/{id}
cancel_eventPOST /me/events/{id}/cancel
delete_eventDELETE /me/events/{id}
respond_to_eventPOST /me/events/{id}/accept
POST /me/events/{id}/decline
POST /me/events/{id}/tentativelyAccept