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

# Outlook Calendar

> Connect Outlook Calendar to Windmill so meetings — including 1:1s — are detected automatically and Windy can prep agendas and surface meeting context.

## Benefits of connecting Outlook Calendar to Windmill

Connecting Outlook Calendar to Windmill brings meeting context into performance conversations — so feedback, coaching, and recognition reflect how your team actually spends their time.

* Surfaces meeting participation, collaboration patterns, and cross-team engagement
* Helps managers see where leadership, mentorship, and support are happening
* Powers 1:1s with calendar data so Windmill can track and organize recurring meetings
* Reduces manual effort when preparing for performance reviews and check-ins
* Ensures contributions like facilitation, stakeholder management, and coordination get recognized

## Connected data

When connected, Windmill securely reads **calendar event metadata** from Microsoft Outlook:

| Data Type                          | How Windmill Uses It                                                 |
| ---------------------------------- | -------------------------------------------------------------------- |
| Event titles and descriptions      | Provides context for what meetings are about                         |
| Attendees and organizers           | Maps collaboration patterns and cross-team involvement               |
| Meeting times and duration         | Shows how time is spent across projects, teams, and stakeholders     |
| Recurring meeting patterns         | Identifies 1:1s, team syncs, and ongoing commitments                 |
| User profiles and group membership | Matches calendar activity to employee profiles and teams in Windmill |

<Info>
  Windmill does **not** access email content, attachments, or message bodies. The integration is limited to calendar data and organizational directory information.
</Info>

## Permissions

Windmill requests **read-only** access via Microsoft Graph API. All permissions require admin consent and are application-level scopes.

| Permission             | Description                                         |
| ---------------------- | --------------------------------------------------- |
| `Calendars.Read`       | Read calendar events for all users                  |
| `User.ReadBasic.All`   | Read basic profile info for all users               |
| `User.Read.All`        | Read full profile details for all users             |
| `Group.Read.All`       | Read all groups in the directory                    |
| `GroupMember.Read.All` | Read group memberships                              |
| `People.Read.All`      | Read relevant people relationships for all users    |
| **No write access**    | Windmill never modifies calendar events or settings |

## Installation

<iframe src="https://www.loom.com/embed/5f69e863d475462ca2a3148888d70287" title="Connecting Outlook Calendar to Windmill" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

<Info>
  You'll need Microsoft 365 admin access to connect Outlook Calendar to Windmill.
</Info>

<Steps>
  <Step title="Open the integrations page in Windmill">
    Go to your [integrations settings](https://app.gowindmill.com/COMPANY/config/integrations) and click **Add integration**.
  </Step>

  <Step title="Select Outlook Calendar">
    Find Outlook Calendar in the list and click **Connect**.
  </Step>

  <Step title="Authenticate with Microsoft">
    Sign in with your Microsoft 365 admin account and grant the requested permissions.
  </Step>

  <Step title="Confirm the connection">
    Once authenticated, you'll be redirected back to Windmill. Calendar data will begin syncing shortly.
  </Step>
</Steps>

## FAQs

<AccordionGroup>
  <Accordion title="Does Windmill access my email?">
    No. Windmill only accesses calendar data. It does not read, store, or process any email content, attachments, or message bodies.
  </Accordion>

  <Accordion title="Does Windmill write anything back to Outlook?">
    No. The integration is strictly read-only. Windmill never creates, modifies, or deletes calendar events.
  </Accordion>

  <Accordion title="How often does Windmill sync calendar data?">
    Continuously. Calendar activity appears in Windmill shortly after events are created or updated.
  </Accordion>

  <Accordion title="Is the integration secure?">
    Yes. All data is encrypted in transit and at rest. Windmill is SOC 2 compliant and uses scoped, revocable OAuth tokens with Microsoft Graph API.
  </Accordion>

  <Accordion title="What happens when an employee leaves?">
    Their past calendar data remains available for context in historical reviews, but Windmill stops syncing once the employee is archived.
  </Accordion>

  <Accordion title="I already use Microsoft SSO to log in. Do I still need to connect this integration?">
    Yes. Microsoft SSO handles authentication only — it doesn't grant Windmill access to calendar data. You'll need to connect the Outlook Calendar integration separately to sync meeting activity.
  </Accordion>
</AccordionGroup>