Suggest meeting times across attendee calendars using Microsoft Graph findMeetingTimes
domain: learn.microsoft.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
POST /me/findMeetingTimes (or /users/{id}/findMeetingTimes for app context) with attendees, a meetingDuration in ISO 8601 format (e.g. PT30M), and optional timeConstraint windows.
Set minimumAttendeePercentage to control how many attendees must be free for a slot to qualify — lower it if you want suggestions despite some conflicts.
Read the returned meetingTimeSuggestions array, each with a confidence score and per-attendee availability breakdown, and present the top suggestions to the user.
Combine with locationConstraint if you also want room/location suggestions returned alongside time slots.
Fall back to a manual free/busy check (getSchedule) if findMeetingTimes returns no suggestions, since it can return an empty array rather than an error when no good slot exists.
Known gotchas
findMeetingTimes only works against Microsoft 365 work/school mailboxes — it is not available for personal outlook.com accounts.
The delegated /me/findMeetingTimes endpoint requires signed-in user context; it does not support application-only (client credentials) auth the way some other calendar endpoints do.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?