Outlook Calendar

Overview

Microsoft’s calendar application for scheduling and managing events. Through Langdock’s integration, you can access and manage Outlook Calendar directly from your conversations.

Authentication: OAuth Category: Microsoft 365 Availability: All workspace plans

---

Available Actions

Get Today’s Events

outlookcalendar.getTodaysEvents

Retrieve all calendar events for today from your calendar or a shared calendar. Always include the user’s timezone

Requires Confirmation: No

Parameters:

• timezone (TEXT, Optional): IANA timezone identifier for proper time display (e.g. ‘Europe/Berlin’)

• calendarowner (TEXT, Optional): Email address to view someone else’s calendar events. Leave empty for your own events

Output: Returns array of today’s events with their details

---

Get Events for Specific Date

outlookcalendar.getEventsforSpecificDate

Retrieve all calendar events for a specific date only. Always include the user’s timezone

Requires Confirmation: No

Parameters:

• date (TEXT, Required): The specific date to retrieve events for in ISO format

• calendarowner (TEXT, Optional): Email address to view someone else’s calendar events. Leave empty for your own events

• timezone (TEXT, Optional): IANA timezone identifier for proper time display

Output: Returns array of events for the specified date

---

Create Events

outlookcalendar.createEvents

Creates outlook calendar events

Requires Confirmation: Yes

Parameters:

• timezone (TEXT, Required): The timezone of the outlook calendar of the user

• calendarId (TEXT, Optional): The unique ID of the calendar to schedule the event in. Leave empty to use default calendar

• locationName (TEXT, Optional): Event location

• endingTime (TEXT, Required): When the event ends in ISO 8601 format

• eventDescription (TEXT, Optional): Description of what is planned for the event

• startingTime (TEXT, Required): When the event starts in ISO 8601 format

• eventSubject (TEXT, Required): The subject or title of the event

• attendees (TEXT, Optional): Comma- or semicolon-separated list of REQUIRED attendee emails

• optionalAttendees (TEXT, Optional): Comma- or semicolon-separated list of OPTIONAL attendee emails

• isonlinemeeting (BOOLEAN, Optional): Set to true to create an online meeting with video conferencing details

• onlinemeetingprovider (TEXT, Optional): Online meeting provider: ‘teamsForBusiness’, ‘skypeForBusiness’, or ‘skype’

• recurrence (TEXT, Optional): Recurrence pattern as JSON

Output: Returns the created event with ID and details

---

Update Event

outlookcalendar.updateEvent

Update an existing calendar event

Requires Confirmation: Yes

Parameters:

• attendees (TEXT, Optional): Comma- or semicolon-separated REQUIRED attendee emails to add or update to required

• optionalAttendees (TEXT, Optional): Comma- or semicolon-separated OPTIONAL attendee emails to add or update to optional

• removeAttendees (TEXT, Optional): Comma- or semicolon-separated attendee emails to remove from the event

• replaceAttendees (BOOLEAN, Optional): If true, replace the entire attendee list with the attendees and optionalAttendees provided

• eventSubject (TEXT, Optional): The subject or title of the event

• timezone (TEXT, Optional): The timezone for the event

• eventId (TEXT, Required): The unique ID of the event to update

• eventDescription (TEXT, Optional): Description of what is planned for the event

• endingTime (TEXT, Optional): When the event ends in ISO 8601 format

• locationName (TEXT, Optional): Event location

• startingTime (TEXT, Optional): When the event starts in ISO 8601 format

• isonlinemeeting (BOOLEAN, Optional): Set to true to make this an online meeting with video conferencing details

• onlinemeetingprovider (TEXT, Optional): Online meeting provider: ‘teamsForBusiness’, ‘skypeForBusiness’, or ‘skype’

• recurrence (TEXT, Optional): Recurrence pattern as JSON

Output: Returns the updated event with new values

---

List Calendars

outlookcalendar.listCalendars

Retrieve accessible calendars including your own and shared calendars

Requires Confirmation: No

Parameters:

• calendarowner (TEXT, Optional): Email address to view someone else’s calendars. Leave empty for your own calendars

• sortby (TEXT, Optional): Sort calendars by field

• includefields (TEXT, Optional): Comma-separated list of fields to include

• top (TEXT, Optional): Maximum number of calendars to return

Output: Returns array of calendars with their details

---

List Calendar Events

outlookcalendar.listCalendarEvents

List calendar events with filtering by subject, date, organizer, and status. Always include the user’s timezone

Requires Confirmation: No

Parameters:

• timezone (TEXT, Optional): IANA timezone identifier for proper time display

• datefrom (TEXT, Optional): Start date for events in ISO format

• dateto (TEXT, Optional): End date for events in ISO format

• subjectcontains (TEXT, Optional): Filter events where subject contains this text

• organizeremail (TEXT, Optional): Filter events by organizer email address

• calendarowner (TEXT, Optional): Email address to view someone else’s calendar events

• calendarid (TEXT, Optional): Specific calendar ID to filter events from

• showas (TEXT, Optional): Filter by availability status: ‘free’, ‘busy’, ‘tentative’, ‘outOfOffice’

• includecancelled (TEXT, Optional): Include cancelled events in results

• sortby (TEXT, Optional): Sort events by field

• maxEvents (TEXT, Optional): Maximum number of events to return

Output: Returns array of events matching the filter criteria

---

Get Event

outlookcalendar.getEvent

Retrieve a specific event by its ID

Requires Confirmation: No

Parameters:

• eventId (TEXT, Required): The unique ID of the event

Output: Returns the event details

---

Delete Event

outlookcalendar.deleteEvent

Delete calendar events by ID or by filtering criteria

Requires Confirmation: Yes

Parameters:

• eventId (TEXT, Optional): The unique ID of a specific event to delete

• attendeeEmail (TEXT, Optional): Delete all events involving this person as attendee or organizer

• subjectContains (TEXT, Optional): Delete all events where subject contains this text

• dateFrom (TEXT, Optional): Start date for deletion range in ISO format

• dateTo (TEXT, Optional): End date for deletion range in ISO format

• calendarId (TEXT, Optional): The unique ID of the calendar to delete events from

• maxEvents (TEXT, Optional): Maximum number of events to delete (safety limit)

Output: Returns confirmation of deleted events

---

Get Calendar Settings

outlookcalendar.getCalendarSettings

Retrieve calendar settings including timezone, working hours, and other configurations

Requires Confirmation: No

Parameters: None

Output: Returns calendar settings including timezone and working hours

---

Find Meeting Times

outlookcalendar.findMeetingTimes

Find available meeting times for yourself and additional participants

Requires Confirmation: No

Parameters:

• participantEmail (TEXT, Optional): Email address of one additional participant

• additionalParticipants (TEXT, Optional): Comma-separated email addresses for multiple participants

• startTime (TEXT, Required): Specify the earliest possible start time for the search, formatted in ISO 8601 Date-Time format

• endTime (TEXT, Required): Latest possible end time in ISO 8601 format

• duration (TEXT, Required): Specify the duration of the available slot using ISO 8601 format

• timezone (TEXT, Required): The timezone of the outlook calendar of the user

• minimumAttendeePercentage (NUMBER, Optional): Minimum percentage of attendees that must be available (1-100)

• maxSuggestions (NUMBER, Optional): Maximum number of meeting time suggestions to return (1-20)

• activityDomain (TEXT, Optional): Time search scope: ‘work’ (business hours), ‘personal’ (includes weekends), ‘unrestricted’ (all hours)

Output: Returns array of available meeting times

---

Triggers

New Event Matching Search

outlookcalendar.newEventMatchingSearch

Triggers when new calendar events matching the specified search query are created

Requires Confirmation: No

Parameters:

• calendarNames (TEXT, Optional): Comma-separated list of calendar names to monitor for new events

• searchQuery (TEXT, Required): Text to search for in event subjects

• daysToInclude (NUMBER, Optional): Number of days in the future to look for events. Default is 30 days

Output: Returns the result of the operation

---

New Event

outlookcalendar.newEvent

Triggers when new calendar events are created in specified calendars

Requires Confirmation: No

Parameters:

• calendarNames (TEXT, Optional): Comma-separated list of calendar names to monitor

• daysToInclude (NUMBER, Optional): Number of days in the future to look for events

Output: Returns the result of the operation

---

Common Use Cases

• Data Management — Manage and organize your Outlook Calendar data

• Automation — Automate workflows with Outlook Calendar

• Reporting — Generate insights and reports

• Integration — Connect Outlook Calendar with other tools

---

Best Practices

1

Getting Started

Enable the Outlook Calendar integration in your workspace settings, authenticate using OAuth, then test the connection with a simple read operation and explore available actions for your use case.

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

---

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

---

Support

For additional help with the Outlook Calendar integration, contact [email protected]