> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Let AI Agents Book Meetings in Outlook Calendar

> Let agents check availability, create meetings, and manage events in Microsoft 365 Outlook Calendar. The gateway injects OAuth tokens, not the agent.

> [!NOTE]
>
> On self-hosted Buckle, Outlook Calendar needs your own Microsoft app first. See [Self-hosted](#self-hosted).

## Overview

Buckle connects AI agents to Outlook Calendar through Microsoft's OAuth flow. Agents can list events, create meetings, check availability, and manage RSVPs. The gateway injects OAuth credentials into requests to the Microsoft Graph API automatically.

This is useful for scheduling agents in Microsoft 365 environments that need to coordinate meetings, check availability, or manage calendars.

## What you will set up

* An Outlook Calendar connection through Microsoft OAuth
* Automatic token injection on Microsoft Graph requests
* Per-agent, per-tool access, such as approval before creating events

## Setup

**1. Open the app**

Open the Buckle dashboard and navigate to **Settings** > **Apps** > **Outlook Calendar**.

**2. Authorize**

Click **Connect Outlook Calendar**. You'll be redirected to Microsoft to sign in and authorize Buckle. Review the permissions and click **Accept**.

![Buckle connect window for Outlook Calendar on Cloud, showing the Connect to Outlook Calendar button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/outlook-calendar/buckle-connect-outlook-calendar.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=c43e5a665e7d0d9c76717ab30a1a7752)

The Outlook Calendar connect window on Buckle Cloud.

## Self-hosted: use your own Microsoft app

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** It's only for self-hosted Buckle without `MICROSOFT_CLIENT_ID` and `MICROSOFT_CLIENT_SECRET` set. One Microsoft app serves all four Microsoft apps in Buckle, so you set it up once.

> [accordion] Set up your Microsoft app
>
> Follow [Self-hosted: use your own Microsoft app](/docs/integrations/outlook-mail.md#self-hosted) on the Outlook Mail page. If you already have one for another Microsoft app, it already works here. Then open **Settings** > **Apps** > **Outlook Calendar** and select **Connect Outlook Calendar**.
>
> ![Buckle Custom credentials card for Outlook Calendar with the setup guide link, the Redirect URI and its copy button, and the Client ID and Client Secret fields.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/outlook-calendar/buckle-custom-credentials-outlook-calendar.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=0b3bce6e48c6d4111fd38b229e5101bf)
>
> Custom credentials for Outlook Calendar in Buckle. The Microsoft app is shared, so the same client works here.

## What agents can do

* List events on your calendar within a date range
* Get details for a specific event (attendees, location, Teams link, body)
* Create new events with attendees, location, and online meeting settings
* Update existing events (reschedule, modify attendees, change details)
* Delete or cancel events
* Check free/busy availability for one or more users
* Respond to event invitations (accept, decline, tentative)
* List all calendars on the account
* Create and manage calendar groups
* Find meeting times that work for all attendees

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Microsoft Graph.

## FAQ

> [accordion] Can an agent check availability without booking?
>
> Yes. Allow read tools and block or require approval for writes when you [grant](/docs/guides/agent-access.md) the connection.

> [accordion] Does the agent see my Microsoft token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] How do I reconnect Outlook Calendar?
>
> Open **Settings** > **Apps** > **Outlook Calendar** and connect again. Agents with access use the new connection automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.