FeaturedPersonal Productivity#Outlook#Outlook Calendar#Microsoft 365#Microsoft Teams#Scheduling#Agent#OAuth2

Teams Meeting Scheduler Agent

Ask in plain words for a meeting with a colleague. An agent reads both Outlook calendars, picks a time you are both free and sends the Teams invitation.

Workflow at a glance

The full canvas, before you import it

Click any node to see its config.

#Outlook#Outlook Calendar#Microsoft 365#Microsoft Teams#Scheduling#Agent#OAuth2

Click a node to select it — same as the Heym editor; the panel shows its settings.

5 nodes · Free & source-available

Teams Meeting Scheduler Agent

"Find 30 minutes with Alex next week about the Q4 roadmap" usually means opening the Scheduling Assistant, comparing two calendars and writing the invitation by hand. This workflow hands that to an agent. It reads your Outlook calendar and your colleague's free/busy in Microsoft 365, picks a slot inside working hours that suits you both, and sends the invitation with a Microsoft Teams link from your account.

What this workflow does

  1. SchedulingRequest takes the request in plain words: who, how long, roughly when and what it is about.
  2. SchedulerAgent calls find_free_time twice: once for your primary calendar and once with your colleague's email address. Microsoft returns their free/busy the way Outlook's Scheduling Assistant shows it, so no access to their calendar is needed beyond what your organization already shares.
  3. The agent keeps only the gaps that are free for both of you, inside 09:00 to 17:00 on weekdays, and picks the earliest one long enough for the meeting.
  4. book_teams_meeting creates the event in your calendar with a Teams link and invites your colleague. Outlook emails the invitation.
  5. SchedulingResult returns the agent's confirmation with the chosen time and the Teams link.

Setup

  1. In the Microsoft Entra admin center, open your app registration (the one you use for Outlook Mail works), add the Web redirect URI https://your-heym-domain/api/credentials/outlook-calendar/oauth/callback and the Microsoft Graph delegated permissions Calendars.ReadWrite, User.Read and offline_access.
  2. In Heym Credentials, create Outlook Calendar (OAuth2) with the Application (client) ID, the client secret and your organization's tenant, click Connect and sign in with your work account. Select it on find_free_time and book_teams_meeting.
  3. Select an LLM credential on SchedulerAgent.
  4. Set Time Zone on both Outlook Calendar nodes to yours, for example Europe/Berlin, and change the working hours in the agent's instructions if yours differ.

Notes

Both calendar nodes are connected to the agent's tool handle, so they run only when the agent calls them. The agent fills the calendar, dates, title, times and attendees itself; the credential and the time zone stay fixed. Reading a colleague's free/busy works within your Microsoft 365 organization. Personal Outlook.com accounts can read their own calendar but cannot add Teams links, so the event is created without one. See the Outlook Calendar documentation for calendars, Teams meetings and updates.

How to import this template

  1. 1Click Import → Copy JSON on this page.
  2. 2Open your Heym and navigate to a workflow canvas.
  3. 3Press Cmd+V / Ctrl+V — nodes appear instantly.
  4. 4Add your API keys in the node config panels and click Run.
More workflow templates
View all templates