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

# Google Calendar Integration — AI Agents & Meeting Context

> Connect Google Calendar to Hyper to index events, attendees, and descriptions so AI agents can answer scheduling questions and surface meeting context.

Your calendar is a map of how your time is actually spent — who you're meeting, what's being discussed, and what decisions are coming up. When you connect Google Calendar to Hyper, it indexes your events along with their descriptions, attendees, and locations, making all of that context searchable through any AI agent. Whether an agent needs to know who attended last Tuesday's sync, what was scheduled around a major decision, or what's coming up this week, your calendar data is ready to answer.

## Connect Google Calendar

<Steps>
  <Step title="Open Settings in the Hyper desktop app">
    Launch the Hyper desktop app and click **Settings** in the navigation, then select **Connections**.
  </Step>

  <Step title="Click Connect next to Google Calendar">
    Find Google Calendar in the list of available integrations and click **Connect**.
  </Step>

  <Step title="Authorize with Google OAuth 2.0">
    A Google sign-in window opens. Sign in with the Google account whose Calendar you want to connect, then grant Hyper the requested permissions. Hyper uses standard Google OAuth 2.0 — your Google password is never stored by Hyper.
  </Step>

  <Step title="Wait for the initial sync to complete">
    Hyper fetches events within a ±90-day window (90 days before and after today), groups them by day, and indexes them. You'll see sync progress in **Settings → Connections**.
  </Step>
</Steps>

## What Hyper Syncs

| What's synced           | Details                                                            |
| ----------------------- | ------------------------------------------------------------------ |
| **Events**              | Title (summary), description, location, attendees, start/end times |
| **Grouping**            | Events are grouped by day for efficient retrieval                  |
| **Time window**         | Fixed ±90-day window — 90 days before and after today              |
| **Incremental updates** | Changes are tracked via Google Calendar's `updatedMin` parameter   |
| **Source links**        | Each event links back to its `htmlLink` in Google Calendar         |

<Info>
  Hyper reads calendar events only — it never creates, edits, or deletes any events on your calendar.
</Info>

<Tip>
  For best results, keep event descriptions and attendee lists populated in your calendar. Richer event metadata means agents can answer more specific questions about your schedule.
</Tip>

## Search Your Calendar with AI Agents

Once your calendar is indexed, your AI agents can search across events within a ±90-day window around today, matching against event summaries, descriptions, locations, and attendee names.

**Example agent queries:**

```text theme={null}
What meetings do I have with the design team this week?
Find any events mentioning "budget review" in the next 90 days
Who attended the product sync on March 12th?
Show me all events with Alice this quarter
What was scheduled on the day we launched the beta?
Read all events for next Monday
Find events at the San Francisco office in the next two weeks
```

**What agents can do:**

| Action             | Description                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------- |
| **Keyword search** | Match events by summary, description, location, or attendee name within ±90 days of today |
| **Read day**       | Retrieve all events for a specific calendar day                                           |
| **Read event**     | Fetch full details of a specific event                                                    |

<Accordion title="About the ±90-day search window">
  Agent search queries are scoped to a rolling window of 90 days before and after today. This keeps results relevant and performant. If you need to surface older events, try reading a specific day directly rather than using keyword search.
</Accordion>

## Reconnect Google Calendar

If your Google OAuth token expires, Hyper will show a **Reconnect** prompt next to Google Calendar in **Settings → Connections**.

<Steps>
  <Step title="Go to Settings → Connections">
    Open the Hyper desktop app and navigate to **Settings → Connections**.
  </Step>

  <Step title="Click Reconnect next to Google Calendar">
    Click the **Reconnect** button. A Google sign-in window opens.
  </Step>

  <Step title="Re-authorize with Google">
    Complete the OAuth flow. Your previously indexed event data is preserved — Hyper resumes incremental sync from where it left off using `updatedMin`.
  </Step>
</Steps>

<Note>
  Reconnecting restores the sync pipeline without deleting existing indexed events. Only events created or modified while the connection was inactive will be re-fetched.
</Note>

## Disconnect Google Calendar

To remove Google Calendar from Hyper, go to **Settings → Connections**, find Google Calendar, and click **Disconnect**. This revokes Hyper's access token and stops future syncing. Previously indexed event data will be removed from your memory layer.

<Warning>
  Disconnecting Google Calendar removes all synced event data from Hyper's memory layer. If you reconnect later, Hyper will perform a fresh sync within the ±90-day window.
</Warning>