View as Markdown
Microsoft Outlook Calendar icon

Microsoft Outlook Calendar ACTION

Find Meeting Times

Suggest meeting times and locations based on organizer and attendee availability. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Outlook Calendar account once, then configure and run Find Meeting Times from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "microsoft_outlook_calendar-find-meeting-times",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_outlook_calendar: { authProvisionId: "apn_xxxxxxx" },
    userId: "User ID or UPN",
    attendees: ["Attendees"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Find Meeting Times inputs
Property Type Description
userId User ID or UPN string
Optional. If set, runs the request for a specific user (/users/{id|userPrincipalName}/findMeetingTimes). If unset, uses the signed-in user (/me/findMeetingTimes).
Optional
attendees Attendees string[]
Optional. A list of attendee email addresses.
Optional
resourceAttendees Resource Attendees string[]
Optional. A list of resource email addresses (for example, rooms/equipment).
Optional
start Start string
Start date-time (yyyy-MM-ddThh:mm:ss) e.g. '2022-04-15T11:20:00'
Required
end End string
End date-time (yyyy-MM-ddThh:mm:ss) e.g. '2022-04-15T13:30:00'
Required
timeZone Time Zone string
Time zone of the event in supported time zones, See the docs
Required Dynamic
activityDomain Activity Domain string
Optional. Restrict suggestions to work hours, personal hours, or unrestricted.
Optional
duration Duration (Minutes) integer
Optional. Meeting duration in minutes. Defaults to 30.
Optional
maxResults Max Results integer
Optional. Maximum number of meeting time suggestions to return (default: 20, max: 50).
Optional
minimumAttendeePercentage Minimum Attendee Percentage integer
Optional. Minimum confidence (0-100) for a suggestion to be returned.
Optional
isOrganizerOptional Is Organizer Optional boolean
Optional. Set to true if the organizer doesn't necessarily have to attend.
Optional
returnSuggestionReasons Return Suggestion Reasons boolean
Optional. Set to true to include a reason for each suggestion in the response.
Optional
suggestLocation Suggest Location boolean
Optional. Set to true to ask Microsoft Graph to suggest meeting locations.
Optional
locations Locations string[]
Optional. A list of location display names to constrain suggestions (for example, conference room names).
Optional
isLocationRequired Location Required boolean
Optional. Set to true if a location is required for the suggestion.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
microsoft_outlook_calendar-find-meeting-times
Version
0.0.3
App
Microsoft Outlook Calendar
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes