# Outlook Calendar

Monitors a Microsoft Outlook calendar for upcoming meetings and fires the agent when a matching event is detected. Useful for automating pre-meeting briefs, post-meeting summaries, or meeting-triggered workflows.

- **Supported agents:** Agentic Flow, Chatbot
- **Route type:** Trigger (poll)
- **Auth:** Microsoft OAuth SSO (delegated permissions)

## Before You Start

1. In the **Azure Portal**, go to **Azure Active Directory → App Registrations → New Registration**.
2. Name the app (e.g. `Neo-CalendarChannel`). Set account types to **Single tenant**.
3. Under **Authentication**, add a **Redirect URI** (Web): `https://<your-neo-domain>/api/channels/oauth/callback`.
4. Note the **Application (client) ID** and **Directory (tenant) ID**.
5. Under **Certificates & Secrets**, create a **Client Secret**.
6. Under **API Permissions**, add these **Delegated** Microsoft Graph permissions: `Calendars.Read`, `User.Read`, `offline_access`, `openid`, `profile`, `email`.
7. Click **Grant admin consent for <tenant>**. All permissions must show Granted status.

Your agent must be published with an active version.

If meeting transcription is required, an **AWS Transcribe** connection must be configured separately.

## Configuration

**Credentials**

- **Client ID** — Application (client) ID from the Azure App Registration. Required.
- **Client Secret** — Client secret value. Required.
- **Tenant ID** — Directory (tenant) ID. Required.
- **User Email** — The calendar owner’s email address. Required.

After saving, click **Login with Microsoft** to complete the OAuth SSO flow.

**Route Settings**

- **Description** — Optional label for this channel instance.
- **Purpose** — Optional note on when the agent should use this channel.
- **Polling Interval (mins)** — How often to check for upcoming calendar events. Default: 5. Range: 1–60.
- **Calendar Name** — Which calendar to monitor. Default: `Calendar`.
- **Join Meeting Minutes Before** — How far in advance of the meeting start time to fire the agent. Default: 5. Range: 1–30.
- **Monitor Teams Meetings Only** — When ON, only Microsoft Teams meetings are processed. Default: ON.
- **Subject Contains** — Only process meetings whose subject matches this filter. Optional.
- **Organizer Email Filter** — Only process meetings organised by this email address. Optional.
- **Skip All-Day Events** — When ON, all-day events are ignored. Default: ON.
- **Minimum Meeting Duration (mins)** — Skip meetings shorter than this duration. Default: 5.
- **Webhook URL** — URL to receive meeting data or transcription output. Optional.
- **Webhook API Key** — API key for authenticating requests to the webhook URL. Optional.
- **Transcriber Provider** — Provider for meeting audio transcription. Default: `aws`.
- **Preferred Language** — Language hint for transcription. Default: `en-US`.
- **Initial Message** — Prompt prefix prepended to the meeting event payload. Optional.