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

# Microsoft Calendar

> How the Microsoft 365 calendar integration works.

## Overview

Ospri Brain integrates with Microsoft 365 calendars (Outlook/Teams) to automatically detect and record your meetings.

## Setup

See [Calendar Sync](/meetings/calendar-sync) for step-by-step setup instructions.

## What Permissions Are Required

When you connect your Microsoft account, Ospri Brain requests:

* **Calendar read access** — To see your upcoming meetings
* **Event details** — Meeting title, time, attendees, video link

Ospri Brain does **not** request write access to your calendar.

## How It Works

<Steps>
  <Step title="OAuth connection">
    You sign in with Microsoft and grant calendar read permissions. Tokens are stored securely.
  </Step>

  <Step title="Calendar creation in Recall.ai">
    A Recall.ai Calendar V2 instance is created with your Microsoft tokens. This enables Recall to read your calendar directly.
  </Step>

  <Step title="Event syncing">
    Calendar webhooks notify Ospri of new, updated, or deleted events in real-time.
  </Step>

  <Step title="Bot scheduling">
    For events with video links, Ospri automatically schedules a bot to join. A deduplication key prevents duplicate bots.
  </Step>

  <Step title="Automatic updates">
    If a meeting is rescheduled or canceled, the bot schedule updates automatically.
  </Step>
</Steps>

## Supported Platforms

Bots can join meetings on:

* **Microsoft Teams**
* **Zoom**
* **Google Meet**
* Other platforms with shareable meeting links

## Troubleshooting

### Calendar not syncing

* Click **Sync → Full Sync** in the Meetings header
* Check that your Microsoft account has active calendar events
* Verify the connection shows a green dot with your email

### Bot not joining meetings

* Ensure the event has a video meeting link (Teams, Zoom, etc.)
* Check that the bot toggle is enabled for that event in the Upcoming tab
* Verify your calendar connection is active

### Disconnecting and reconnecting

If you experience persistent issues:

1. Disconnect your calendar (click X next to your email)
2. Wait 30 seconds
3. Reconnect via **Connect Microsoft Calendar**