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

# Google Calendar

> Connect your Google Calendar so VIS42 agents can check your schedule and look up meeting details.

Connect your Google Calendar to give VIS42 agents a live view of your schedule. Your agents can check availability, retrieve meeting details, and search across your events — all without leaving the conversation.

## What your agents can do

Once connected, VIS42 agents have three read-only Google Calendar capabilities:

* **List upcoming events** — returns events in a date range you specify, with title, time, location, and status
* **Get a single event** — fetches full detail: description, attendees with RSVP status, meeting link, and location
* **Search events by text** — finds events matching a keyword in titles, descriptions, locations, or attendee names

The integration is read-only — agents can view your calendar but cannot create, modify, or delete events.

Which agent uses which capability depends on what you ask. For example:

* Ask **Mercury** *"Am I free next Tuesday afternoon?"* and it will list your events for that window.
* Ask **Themis** *"Summarize my meetings from last week"* and it will list and describe each event.
* Ask **Pluto** *"Do I have any compliance review meetings this month?"* and it will search for matching events and return the details.

## Connect your calendar

<Steps>
  <Step title="Open agent settings">
    Open any agent (Mercury, Themis, or Pluto) and scroll to the **Connected Services** section.
  </Step>

  <Step title="Click Connect on the Google Calendar card">
    You'll be redirected to Google's sign-in and consent screen.
  </Step>

  <Step title="Sign in and authorize">
    Sign in with the Google account that owns the calendar you want to connect, then click **Allow**. VIS42 requests read-only access — it cannot modify your calendar. You'll be sent back to VIS42 with the integration marked as **Enabled**.
  </Step>
</Steps>

## Privacy and scope

* The connection is **per user, per business** — each team member connects their own Google account.
* VIS42 requests **read-only** calendar access. It cannot create, edit, or delete events.
* Your access token is encrypted at rest.
* Disconnect at any time from **Connected Services** in the agent settings page. Your token is revoked and removed from VIS42.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent says there are no events but I have meetings scheduled">
    Check that you connected the right Google account. If your company uses Google Workspace, you may have multiple accounts. Disconnect and reconnect, selecting the correct account.
  </Accordion>

  <Accordion title="The integration shows Enabled but the agent can't see events">
    Your token may have expired. Disconnect and reconnect from **Connected Services** to get a fresh token.
  </Accordion>

  <Accordion title="Agent can see some events but not others">
    VIS42 reads from your primary calendar. Events on secondary or shared calendars (e.g., a team calendar) may not appear.
  </Accordion>

  <Accordion title="I want to revoke access from Google's side">
    In your Google Account, go to **Security** → **Third-party apps with account access** → find **VIS42** → **Remove access**. You'll also want to disconnect from VIS42's agent settings to clean up the local record.
  </Accordion>
</AccordionGroup>