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

# Google Calendar

> Google Calendar is a scheduling and events service. Connect it to WPOS and the agent can use it as part of the work it does on your site.

Google Calendar holds your schedule and events. Connected to WPOS, the agent can read availability and create events as part of the work it does on a site, which is useful for events pages and booking flows that need to respect a real calendar.

**Category:** Scheduling   **Actions available:** 45+

## What you can do

* Read events across your calendars
* Create, update, and delete events
* Check availability before confirming a booking

## Example requests

Once Google Calendar is connected, ask in the [Command Center](/operate/command-center):

```text theme={null}
List my events for the next seven days.
Publish an events page from the team calendar.
Create a calendar entry for each post in the content schedule.
```

## Before you connect

* A Google account with Calendar. A free personal account is enough.
* **Make changes to events** permission on any calendar WPOS should write to.
* Know which calendar you mean. Most accounts have several.

## Connect it

<Steps>
  <Step title="Open WPOS">
    In WordPress admin, open **WPOS**. You land on the chat screen.

    <Frame caption="WPOS opens on the chat screen.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/01-wpos-home.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=bb083c3c0d5287d640eb20d2e53834c6" alt="The WPOS chat screen in WordPress admin." width="1918" height="876" data-path="images/connectors/google-calendar/01-wpos-home.png" />
    </Frame>
  </Step>

  <Step title="Open a new tab and choose Connectors">
    Click the **+** button to open the launcher panel, then choose **Connectors**.

    <Frame caption="The launcher panel. Connectors is the fifth entry.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/02-new-tab-connectors.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=e8ac6288dfdfef32ab7585d6040c7083" alt="The WPOS launcher panel listing Preview, Site tree, Files, Skills, Connectors, and Settings." width="1920" height="887" data-path="images/connectors/google-calendar/02-new-tab-connectors.png" />
    </Frame>
  </Step>

  <Step title="Find the connector">
    Every available connector is listed alphabetically, each with a button showing what it needs.

    <Frame caption="The Connectors panel, sorted alphabetically.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/03-connectors-list.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=72db178003a1719fded1a112252b9d6f" alt="The WPOS Connectors panel listing Calendly, Canva, Figma, Google Analytics, Google Calendar, and Google Docs." width="1913" height="891" data-path="images/connectors/google-calendar/03-connectors-list.png" />
    </Frame>
  </Step>

  <Step title="Search and press Connect">
    Type `Google Calendar` into **Search for integrations**, then press **Connect**.

    <Frame caption="Search narrows the list to one row.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/04-search.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=c6780b2938523867deaf6f696497f52a" alt="The Google Calendar row with a Connect button." width="1917" height="892" data-path="images/connectors/google-calendar/04-search.png" />
    </Frame>
  </Step>

  <Step title="Choose your Google account">
    Pick the account whose calendars you want WPOS to reach.

    <Frame caption="Google asks which account to connect.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/05-account-chooser.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=3d0c25b0890c959145728ef3ae28bf23" alt="Google's account chooser, headed to continue to Composio." width="1917" height="892" data-path="images/connectors/google-calendar/05-account-chooser.png" />
    </Frame>
  </Step>

  <Step title="Grant calendar access">
    Google asks for two permissions: view and edit events on all your calendars, and see, edit, share and permanently delete all the calendars you can access.

    <Warning>
      The second permission includes **permanent deletion of calendars**. Read it before approving, and connect a test account first if that concerns you. The checkboxes also start empty, so tick **Select all**.
    </Warning>

    <Frame caption="Two permissions, including permanent deletion.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/06-consent.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=64292c2cae61e94bfad1dc379f5665c4" alt="The Google consent screen listing two Calendar permissions with empty checkboxes." width="1913" height="887" data-path="images/connectors/google-calendar/06-consent.png" />
    </Frame>
  </Step>

  <Step title="Confirm in WPOS">
    The row reads **Connected** and a green "Google Calendar connected" banner appears in the chat.

    <Note>
      The connected row is labelled **Googlecalendar**, one word. Cosmetic only.
    </Note>

    <Frame caption="Connected. The row label reads Googlecalendar.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-calendar/07-connected.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=d89e304d1eda2c7a5d35f333a2b2c482" alt="The connected row labelled Googlecalendar with a Disconnect button." width="1920" height="892" data-path="images/connectors/google-calendar/07-connected.png" />
    </Frame>
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connected, but no events are returned">
    The permission checkboxes were left unticked. Disconnect, reconnect, and tick **Select all**.
  </Accordion>

  <Accordion title="Events are created at the wrong time">
    A timezone mismatch. State the timezone explicitly in your prompt, or set the calendar default to match your audience.
  </Accordion>

  <Accordion title="Events land on the wrong calendar">
    Without a calendar named, events go to the primary one. Name the target calendar in your prompt.
  </Accordion>

  <Accordion title="The popup looks like it closed mid sign-in">
    Google sometimes severs the popup link to WordPress. WPOS keeps waiting for up to 45 seconds, so let it finish rather than pressing Connect again.
  </Accordion>
</AccordionGroup>

For popup failures, expired connections, and other issues shared across every
connector, see [Introducing Connectors](/connect/connectors).
