ms-graph-calendar_skill

Overview

This skill finds available meeting times and free/busy slots for company employees using the Microsoft Graph Calendar API. It helps resolve attendee emails, search date ranges, and return prioritized meeting slots or a free/busy summary. The skill is read-only and designed for scheduling, availability checks, and planning across teams.

How this skill works

The skill authenticates with Azure AD using app-only credentials and acquires a Graph API token. It resolves attendee identities (nickname lookup, then directory search), parses the requested date range, duration, and timezone, and calls Graph endpoints (findMeetingTimes or getSchedule) to compute availability. Results are formatted as clear slot lists or free/busy blocks and returned to the user with suggested next steps.

When to use it

• Schedule a meeting and need common free slots for multiple employees
• Check if a specific person is available at a given time window
• List upcoming busy blocks for one or more people to avoid conflicts
• Suggest meeting times across a large team or department
• Verify availability before sending calendar invites

Best practices

• Collect missing details up front: attendees, date range, duration, and timezone
• Use nickname-to-email mapping for quick resolution, then fall back to directory search
• Use findMeetingTimes for small groups (≤10) and getSchedule for larger groups or visual free/busy
• Default to a sensible timezone if none provided and confirm ambiguous attendee names
• Widen the search window or shorten duration if no common slots are found

Example use cases

• Find a 1-hour slot this week where Alice, Bob, and Carol are all free and return the top 3 options
• Check if John is free tomorrow afternoon and report free/busy blocks from 12:00–18:00
• Show the marketing team’s availability next week by listing users and aggregating their free/busy
• Suggest meeting slots across a department of 20 people using getSchedule to inspect busy intervals
• Confirm availability for a cross-timezone meeting by converting and presenting slots in the requested timezone