Microsoft Outlook Calendar
How to configure the Microsoft Outlook Calendar MCP connector
The Microsoft Outlook Calendar connector allows the chatbot to read and manage calendar events through Microsoft Graph API using the ms-365-mcp-server.
Connector Settings
| Field | Value |
|---|---|
| Integration Type | MCP |
| Name | Microsoft Outlook Calendar |
| URL | https://ms365-calendar.mcp.mitigate.dev/mcp |
| Transport Type | Streamable HTTP |
| Authentication Type | OAuth 2.1 |
| OAuth Scopes | openid profile offline_access Calendars.ReadWrite Calendars.Read.Shared |
This MCP server supports Dynamic Client Registration (RFC 7591) — OAuth Client ID and Client Secret are not required.
A tenant admin must grant admin consent for the Mitigate AI Platform application before users can connect.
Application ID: bc2b3dde-4f74-483d-93c0-919c4b804b48
Use this direct link to grant consent: Grant admin consent
Or follow the manual steps:
- Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.
- Browse to Identity → Applications → Enterprise applications → All applications.
- Search for Mitigate AI Platform and select it.
- Select Permissions under Security.
- Review the permissions and select Grant admin consent.
OAuth Scopes
See all available scopes in the Microsoft Graph permissions reference.
| Scope | Description |
|---|---|
openid | Enables OpenID Connect sign-in |
profile | Access to the user's basic profile information |
offline_access | Allows token refresh without re-prompting the user |
Calendars.Read | Read the user's calendars and events |
Calendars.ReadWrite | Read and write access to the user's calendars and events (includes Calendars.Read) |
Calendars.Read.Shared | Read shared calendars and find meeting times |
Usage Examples
Once connected, users can interact with Outlook Calendar through natural language:
- "What meetings do I have today?"
- "Show my calendar for this week"
- "When is my next meeting with the product team?"
Tools
List Calendars
list-calendars
Get all the user's calendars.
List Calendar Events
list-calendar-events
Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Parameters:
- timezone - IANA timezone name (e.g.,
America/New_York) for calendar event times. If not specified, times are returned in UTC
Get Calendar Event
get-calendar-event
Get the properties and relationships of the specified event object.
Parameters:
- eventId - The ID of the event
- timezone - IANA timezone name for calendar event times
Get Calendar View
get-calendar-view
Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's default calendar.
Parameters:
- startDateTime - The start date and time of the time range in ISO 8601 format (e.g.,
2019-11-08T19:00:00-08:00) - endDateTime - The end date and time of the time range in ISO 8601 format
- timezone - IANA timezone name for calendar event times
Create Calendar Event
create-calendar-event
Create a new event in the user's default calendar.
Parameters:
- body - The event object to create
Update Calendar Event
update-calendar-event
Update the properties of an event object.
Parameters:
- eventId - The ID of the event to update
- body - The updated event properties
Delete Calendar Event
delete-calendar-event
Removes the specified event from the containing calendar. If the event is a meeting, deleting the event on the organizer's calendar sends a cancellation message to the meeting attendees.
Parameters:
- eventId - The ID of the event to delete
Get Specific Calendar View
get-specific-calendar-view
The calendar view for a specific calendar. Returns expanded recurring event instances within a date range.
Parameters:
- calendarId - The ID of the calendar
- startDateTime - The start date and time in ISO 8601 format
- endDateTime - The end date and time in ISO 8601 format
- timezone - IANA timezone name for calendar event times
List Specific Calendar Events
list-specific-calendar-events
The events in a specific calendar.
Parameters:
- calendarId - The ID of the calendar
- timezone - IANA timezone name for calendar event times
Get Specific Calendar Event
get-specific-calendar-event
Get a specific event from a specific calendar.
Parameters:
- calendarId - The ID of the calendar
- eventId - The ID of the event
- timezone - IANA timezone name for calendar event times
Create Specific Calendar Event
create-specific-calendar-event
Create a new event in a specific calendar.
Parameters:
- calendarId - The ID of the calendar
- body - The event object to create
Update Specific Calendar Event
update-specific-calendar-event
Update an event in a specific calendar.
Parameters:
- calendarId - The ID of the calendar
- eventId - The ID of the event to update
- body - The updated event properties
Delete Specific Calendar Event
delete-specific-calendar-event
Delete an event from a specific calendar.
Parameters:
- calendarId - The ID of the calendar
- eventId - The ID of the event to delete
List Calendar Event Instances
list-calendar-event-instances
The occurrences of a recurring series, if the event is a series master. Includes occurrences that are part of the recurrence pattern and exceptions, but not cancelled occurrences.
Parameters:
- calendarId - The ID of the calendar
- eventId - The ID of the recurring event
- startDateTime - The start date and time in ISO 8601 format
- endDateTime - The end date and time in ISO 8601 format
- timezone - IANA timezone name for calendar event times
Find Meeting Times
find-meeting-times
Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints.
Parameters:
- body - Meeting time suggestions request object