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

# Google Calendar

> Connect Google Calendar to xpander and give agents its 27 actions: how to sign in and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://www.googleapis.com/calendar/v3` and carry an OAuth 2.0 token obtained with **Sign in with Google** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 27 actions, as they appear in the skill panel. 16 of them create, change or delete something in Google Calendar; mark those under **These actions need approval** when you add the skill to an agent.

* **Event management** (10): Get Calendar Events by ID, Create Event in Calendar by ID, Import Event to Calendar by ID, Quick Add Event to Calendar by ID, Get Event by ID, Replace Event by ID, Update Event by ID, Get Recurring Event Instances, Move Event to Another Calendar, Get User Calendar List Entries
* **Calendar management** (8): Create New Secondary Calendar, Get Calendar Metadata by ID, Replace Calendar Metadata by ID, Update Calendar Metadata by ID, Add Calendar List Entry, Get Calendar List Entry by ID, Replace Calendar List Entry by ID, Update Calendar List Entry by ID
* **Access control management** (5): Get Calendar ACL Rules by ID, Create Calendar ACL Rule by ID, Get ACL Rule by ID, Replace ACL Rule by ID, Update ACL Rule by ID
* **User settings management** (2): Get All User Settings, Get User Setting by ID
* **Color management** (1): Get Color Definitions
* **Free busy service** (1): Get Free Busy Info

## Authentication Options

<Tabs>
  <Tab title="Built-in xpander Auth">
    The simplest way to connect Google Calendar is by using xpander's built-in authentication:

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Google Calendar** and select it.
    3. Click **Sign in with Google Calendar**.
    4. Grant xpander permission to access your account.
    5. Your Google Calendar integration is now ready to use.

    <Note>
      This method is recommended for most users. xpander securely manages your OAuth tokens without exposing any credentials.
    </Note>
  </Tab>

  <Tab title="API Access">
    ### Generate a Google Calendar API Key

    1. Log in to your [Google Cloud Console](https://console.cloud.google.com/).

    2. Create a new project or select an existing one.\\
           <img src="https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/google-calendar/img_1.png?fit=max&auto=format&n=pzRhrv6nqUySeaGz&q=85&s=31979564f05648f24a75fd3bd4e5e8e4" alt="Img 1" width="3175" height="1619" data-path="images/connectors/google-calendar/img_1.png" />

    3. Go to the [Google Cloud API Library](https://console.cloud.google.com/apis/library).\\
           <img src="https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/google-calendar/img_2.png?fit=max&auto=format&n=pzRhrv6nqUySeaGz&q=85&s=183db5e4eea983844cd8296b39086efb" alt="Img 2" width="3170" height="1551" data-path="images/connectors/google-calendar/img_2.png" />

    4. Search for and select **Google Calendar API**, then click **Enable**.

    5. In the sidebar, go to **Credentials**.

    6. Click **Create credentials**, and select **API key**.\\
           <img src="https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/google-calendar/img_3.png?fit=max&auto=format&n=pzRhrv6nqUySeaGz&q=85&s=61e3839ddec6a6cffa602358f237a8eb" alt="Img 3" width="3272" height="1646" data-path="images/connectors/google-calendar/img_3.png" />

    7. Restrict the API key to Google Calendar API only (optional but recommended).\\
           <img src="https://mintcdn.com/xpanderai-099931d1/pzRhrv6nqUySeaGz/images/connectors/google-calendar/img_4.png?fit=max&auto=format&n=pzRhrv6nqUySeaGz&q=85&s=f441996b3d5e0819429cef9c99f6effe" alt="Img 4" width="3228" height="1635" data-path="images/connectors/google-calendar/img_4.png" />

    ### Connect Google Calendar in xpander

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Google Calendar** and select it.
    3. Click **Other auth options**.
    4. Enter a **connection name**, e.g., "xpander-google-calendar".
    5. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).
    6. Select **API Key** as the authentication method.
    7. Paste the Google Calendar API key into the provided field.
    8. Choose **Basic** as the **Type**.
    9. Click **Connect**.

    <Warning>
      API keys provide limited functionality and are best for read-only operations on public files. For full access, use OAuth methods.
    </Warning>
  </Tab>
</Tabs>

## Give an agent the Google Calendar skill

Once Google Calendar is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Google Calendar**. The skill panel lists the Google Calendar actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)
* [Google Calendar API Documentation](https://developers.google.com/workspace/calendar/api/guides/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.