7 min read

Connecting Microsoft Outlook Calendar to Knoon Agents Using Tools

If your clinic, salon, or service business still relies on staff to answer calls and book appointments, Knoon can automate it. Your agents can check availability, book appointments, and update events directly in Outlook. This guide shows how to connect Outlook Calendar to Knoon.
Connecting Microsoft Outlook Calendar to Knoon Agents Using Tools

When your business uses Outlook for scheduling (e.g. a clinic, consultancy or salon), it’s just as powerful to let your Knoon agents read availability, book appointments and update events, all automatically and in real time. This post shows you how to connect Microsoft Outlook Calendar to Knoon.

Why Outlook Calendar & Knoon

Many businesses (especially enterprises or those already on Microsoft 365) use Outlook Calendar as their main scheduling backbone.

With Outlook & Knoon, your agents can:

  • Retrieve all calendars (personal, shared, team) the user has access to
  • List events (to check existing bookings)
  • Read free/busy info to find open slots
  • Create new events (book appointments)
  • Update existing events (reschedules, changes)

Essentially, the same capabilities you had with Google Calendar, now available for Outlook users.

Who Should Use Outlook Calendar with Knoon?

This integration is perfect for teams that run on scheduled appointments or time-based workflows, including:

  • Clinics and healthcare providers managing consultations
  • Hair salons and beauty services coordinating stylist schedules
  • Wellness professionals like therapists, chiropractors, and trainers
  • Sales or demo teams arranging product walkthroughs
  • Operations teams planning staff shifts or room usage
  • Service providers handling repairs, installations, or on-site visits
  • Consultants and freelancers booking client sessions
  • Educators or coaches organizing lessons and one-on-one meetings

If scheduling is central to your work, Knoon and Outlook Calendar make it faster, smoother, and fully automated without humans.

How to Create and Equip Outlook Calendar Tool in Knoon


Create a Microsoft Outlook Calendar Tool

Here’s how to set up the Outlook Calendar integration in Knoon.

Create a Outlook Calendar tool in Knoon easily.
Create a Outlook Calendar tool in Knoon easily.
  1. Open Knoon.
  2. Go to Bots → Tools.
  3. Press Create.
  4. Enter a name and description for your tool.
  5. (Optional) Enable Provide alternative description to LLM for clearer instructions.
  6. Choose App as the Tool Type.
  7. Press Select an App Action.
  8. Pick Microsoft → Outlook Calendar.
  9. Choose an action such as List Event, Create Event, Update Event, List Availability & more.
  10. Define your agent variables.
  11. Configure action payload if needed.
  12. Press Submit.

Attach the Tool to an Agent

Attach the Google Calendar tool to an agent in Knoon.
Attach the Google Calendar tool to an agent in Knoon.
  1. Go to Bots → Agents.
  2. Select an agent.
  3. Scroll to the Tools section.
  4. Select the Outlook Calendar tool you created.
  5. Press Submit.

Your agent is now fully equipped to check availability, create appointments, and update events in Microsoft Outlook Calendar directly within conversations.

Demo Workflow: Booking Dr. Yee’s Appointment via Outlook

Let’s walk through the same test case once again but using Outlook Calendar.

A clinic assistant agent helps customers schedule appointments and checks whether the doctor is available. For this demo, we’ll assume there is one doctor i.e. Dr Yee.

Setup Outlook Calendar Tools

To automate scheduling for this example clinic workflow, you will create 5 Outlook Calendar tools:

  1. Check Availability (List Availability)
  2. Create Appointment (Create Event)
  3. Find Existing Appointment (Search events by extended properties)
  4. Update Appointment (Update Event)
  5. Cancel Appointment (Cancel Event)

Below is a step-by-step guide for setting up each tool.

Check Dr Yee's Availability

  1. In the create a new tool page,
    Name: Check Dr's Yee calendar
    Description: List time slots of Dr Yee calendar.
  2. Choose App as the Tool Type.
  3. Press Select an App Action.
  4. Pick Microsoft → Outlook Calendar → List Availability.
  5. Select Dr Yee's Outlook Calendar.
  6. Configure the agent variables.
    Name: startDate
    Description: Start date of the query in IOS8601.

    Name: endDate
    Description: End date of the query in IOS8601.
  7. Configure the action payload.
    start: {{startDate}}
    end: {{endDate}}
    durationMinutes: 30
  8. Done!

Create Appointment in Dr Yee's Calendar

  1. In the create a new tool page,
    Name: Book Appointment with Dr Yee.
    Description: Create an appointment with Dr Yee in the calendar.
  2. Choose App as the Tool Type.
  3. Press Select an App Action.
  4. Pick Microsoft → Outlook Calendar → Search.
  5. Select Dr Yee's Outlook Calendar.
  6. Configure the agent variables.
    Name: start-time
    Description: Start date time of the appointment with Dr Yee in IOS8601.

    Name: end-time
    Description: End date time of the appointment with Dr Yee in IOS8601.

    Name: title-appointment
    Description: Title of the appointment

    Name: summarise-appointment
    Description: A summary of the appointment
  7. Configure the action payload.
    summary: {{data.contact.email}} : {{title-appointment}}
    Description: {{summarise-appointment}}.
    startDateTime: start-time
    endDateTime: end-time
  8. Done!

Find Existing Dr Yee's Appointment

  1. In the create a new tool page,
    Name: Find Existing Dr Yee's Appointment.
    Description: Find an eventID in Dr Yee's calendar.
  2. Choose App as the Tool Type.
  3. Press Select an App Action.
  4. Pick Microsoft → Outlook Calendar → Search events by extended properties.
  5. Select Dr Yee's Outlook Calendar.
  6. Configure the action payload.
    Query: {{data.contact.email}}
  7. Done!

Update an Appointment with Dr Yee

  1. In the create a new tool page,
    Name: Update an Appointment with Dr Yee
    Description: Update an Appointment in Dr Yee's calendar
  2. Choose App as the Tool Type.
  3. Press Select an App Action.
  4. Pick Microsoft → Outlook Calendar → Update Event.
  5. Select Dr Yee's Outlook Calendar.
  6. Configure the agent variables.
    Name: eventId
    Description: eventID of the appointment that needs to be modified.

    Name: start-time
    Description: Start date time of the appointment with Dr Yee in IOS8601.

    Name: end-time
    Description: End date time of the appointment with Dr Yee in IOS8601.

    Name: title-appointment
    Description: Title of the appointment

    Name: summarise-appointment
    Description: A summary of the appointment
  7. Configure the action payload.
    eventID: {{eventID}}
    summary: {{data.contact.email}} : title-appointment
    Description: summarise-appointment
    startDateTime: start-time
    endDateTime: end-time
  8. Done!

Cancel Existing Dr Yee's Appointment

  1. In the create a new tool page,
    Name: Cancel Appointment in Dr Yee's Calendar
    Description: Cancel Appointment in Dr Yee's Calendar
  2. Choose App as the Tool Type.
  3. Press Select an App Action.
  4. Pick Microsoft → Outlook Calendar → Cancel Event
  5. Select Dr Yee's Outlook Calendar.
  6. Configure the agent variables:
    Name: eventID
    Description: This is the eventID of the appointment to be cancelled.
  7. Configure the action payload.
    eventID: {{eventId}}
  8. Done!

Once the tools are setup, attach them to an agent and test its response.

Ask the agent to find an available 1 PM slot the following week

Request the agent to look for a 2PM opening this coming week. It found an available 2PM slot on Friday.
Request the agent to look for a 2PM opening this coming week. It found an available 2PM slot on Friday.

We began by asking the agent to look for a 2 PM appointment on any day the following week and to recommend the next available option. The agent reviewed Dr. Yee’s schedule and correctly reported that Dr. Yee was not free at 2 PM on December 1 to December 4. It then found an open 2 PM slot on Friday, December 5, and asked whether we would like to reserve it.

Friday 2PM slot is available as shown in Dr Yee's Outlook calendar.
Friday 2PM slot is available as shown in Dr Yee's Outlook calendar.

After checking Dr. Yee’s calendar, we confirmed that the booking appeared exactly as expected. The date and time were correct, the user’s email was captured, and the appointment title and summary matched the information we provided.

After confirming the appointment details with the user, the agent creates an appointment in Dr. Yee’s calendar.
After confirming the appointment details with the user, the agent creates an appointment in Dr. Yee’s calendar.
The 2 PM Friday appointment has been successfully added to Dr. Yee’s Outlook Calendar.
The 2 PM Friday appointment has been successfully added to Dr. Yee’s Outlook Calendar.

A solid start! 🥂

Change appointment to another date and time

Request the agent to change the date and time of an existing appointment.
Request the agent to change the date and time of an existing appointment.

Next, we asked the agent to move the appointment to Thursday 2PM instead of keeping the Friday 2 PM slot. The agent searched for the appointment under the user’s email and reviewed Dr. Yee’s availability. It saw that the 2 to 3PM slot on Thursday was already taken and suggested a list of available slots.

The agent identifies suitable new time slots and confirms them with the user.
The agent identifies suitable new time slots and confirms them with the user.

Once we confirmed that 3PM on Thursday was suitable, the agent retrieved the event ID and updated the appointment to the new date and time without any issues.

The agent proceeds to make the booking.
The agent proceeds to make the booking.
The event has been updated to Thursday at 3 PM in Dr. Yee’s calendar.
The event has been updated to Thursday at 3 PM in Dr. Yee’s calendar.

And just like that, the entire change was completed automatically, without a single person stepping in.

Cancel Appointment

Lastly, we tested appointment cancellation. In this scenario, the user had two appointments with Dr. Yee. We asked the agent to cancel all appointments for the week. The agent first clarified whether it should cancel a specific appointment or all of them.

The user requested to cancel all appointments with Dr. Yee.
The user requested to cancel all appointments with Dr. Yee.
In Outlook Calendar, the user has two appointments booked: one on Tuesday, 2 December, and another on Friday, 5 December.

After the user confirmed, the agent located all events under the user’s email for that week and successfully cancelled them.

The agent then went ahead and cancelled both appointments.
The agent then went ahead and cancelled both appointments.
Both appointments were successfully cancelled and removed from Outlook Calendar.
Both appointments were successfully cancelled and removed from Outlook Calendar.

Yayyy! 👏🏻


By integrating Outlook Calendar with Knoon, you bring all the scheduling automation benefits to Outlook users. Whether you run a clinic, consultancy, salon, or any appointment-based business, this gives you a flexible way to let your AI agents handle bookings, availability checks, reschedules, and more...

...without manual effort.