> ## 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.

# Calendar Sync

> Connect your Microsoft calendar to automatically schedule meeting bots.

## Connecting Your Calendar

<Steps>
  <Step title="Go to Meetings">
    Navigate to the **Meetings** page from the sidebar.
  </Step>

  <Step title="Click Connect Microsoft Calendar">
    In the header, click the **Connect Microsoft Calendar** button.
  </Step>

  <Step title="Sign in with Microsoft">
    You'll be redirected to Microsoft's OAuth page. Sign in with your work account and grant calendar read permissions.
  </Step>

  <Step title="Verify connection">
    After being redirected back, you'll see a **green dot** and your email address in the Meetings header. Your upcoming events will populate within 30 seconds.
  </Step>
</Steps>

<Note>
  **Alex's screenshot note:** Take a screenshot of the Meetings header showing the green connected indicator with the email address, and the Sync dropdown.
</Note>

## How Calendar Sync Works

Once connected, Ospri Brain:

1. **Syncs your calendar** — Reads your upcoming events from Microsoft 365
2. **Identifies video meetings** — Filters for meetings with Teams, Zoom, or other video links
3. **Schedules bots** — Automatically creates an AI bot for each eligible meeting
4. **Receives webhook updates** — Gets real-time notifications when events change

### Automatic Bot Scheduling

By default, Ospri schedules a bot for every meeting that has a video link. You can toggle individual meetings on/off in the [Upcoming](/meetings/upcoming) tab.

### Per-User Bots

Each Ospri Brain user with a connected calendar gets their own bot. If three team members are in the same meeting, each can have their own bot — and each can control (pause, resume, kick) their own bot independently.

## Sync Options

Click the **Sync** dropdown in the Meetings header for these options:

| Option               | Description                                             |
| -------------------- | ------------------------------------------------------- |
| **Quick Sync**       | Syncs the next 60 minutes of events                     |
| **Sync Active Bots** | Checks status of bots currently in meetings             |
| **Full Sync**        | Complete resync of all calendar events and bot statuses |

## Disconnecting Your Calendar

To disconnect:

1. Click the **X** button next to your connected email in the Meetings header
2. Confirm the disconnection
3. All scheduled bots for your calendar are automatically unscheduled
4. Your calendar connection in the `user_calendars` table is marked as disconnected

<Warning>
  Disconnecting your calendar stops all automatic bot scheduling. Existing recordings and transcripts are preserved.
</Warning>

## Technical Details

Ospri Brain uses **Recall.ai Calendar V2** for calendar integration:

* Each user creates a separate Recall calendar with their Microsoft OAuth tokens
* Bot scheduling uses a **deduplication key** to prevent duplicate bots in the same meeting
* Calendar webhooks notify Ospri of event changes in real-time
* Bots are configured with automatic leave settings (timeout after silence, after everyone leaves, or after detecting only bots remain)