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.

​

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

​

Best Practices

​

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 support@langdock.com