> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/third-party-apps/google-calendar.md).

# Google Calendar

Learn using a step-by-step guide on how to integrate Google Calendar with AI Agents

## What is Google Calendar?

Google Calendar is a widely used cloud-based scheduling tool from Google that helps individuals and organizations plan, manage, and track events. It offers features such as multi-calendar support, automated reminders, real-time synchronization across devices, and integrations with productivity tools, making it a cornerstone for efficient time and resource management.

***

## Benefits of Integrating Google Calendar with AI Agent

* **Automated Scheduling**: Eliminate the need for manual appointment booking as the AI Agent can directly create and confirm calendar events.
* **Real-time Synchronization**: Events and updates made through BotPenguin instantly reflect in Google Calendar, ensuring accuracy.
* **Reduced No-Shows**: Automated reminders sent via the AI Agent minimize missed appointments.
* **Streamlined Customer Experience**: Customers can schedule meetings, demos, or consultations directly during the chat without extra steps.
* **Multi-User Flexibility**: Supports multiple team members’ calendars, enabling intelligent routing and booking across availability slots.

***

## Steps to Integrate Google Calendar with AI Agent:

### Step 1: Access Integrations

1. Log in to [BotPenguin](mailto:undefined), and click on the **More** icon in the left-hand sidebar.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/aHY9yaFyV3fbPEaKRj56/images/google-calendar-step-1.png)

2. Navigate to **Integrations → Google Calendar**.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ihha7n4fKztblGMv4OXL/images/google-calendar-step-2.png)

3. On the Google Calendar page, click **Connect → Connect Google Calendar**.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/8bfRbgKT4yv4wa7E3xm0/images/google-calendar-step-3.png)

4. Complete the **Google Sign-In process** and allow permissions.

***

### Step 2: Configure Google Calendar Accounts

1. After connection, you will see a configuration table with:
2. **Configuration Name** (email ID).
3. **Details** (connected account information + access token).
4. **Status Toggle** (enable/disable connection).
5. **Actions** (delete an integrated account).

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/0J4iSO5eC2e7iDkuDjZS/images/google-calendar-step-4.png)

6. To add another account, click **Add New Configuration** and repeat the sign-in.

***

### Step 3: Prepare Custom Attributes (Mandatory)

1. Go to the left-hand sidebar and click on More.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/sZO9H4dCfhACwFtyRmQb/images/google-calendar-step-5.png)

4. A table will appear with three options. Select the third option: **Save Agent Response**.

* **Attribute Key**: A unique identifier for the key (e.g., `meeting_title`).
* **Attribute Name**: The display label (e.g., *Meeting Title*).
* **Attribute Type**: Choose from available formats such as Select, Event, Timing, or use the earlier examples (*Single Line Text*, *Multi-Line Text*, *Date & Time Picker*).

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/9052y1glGx9z6UOo1Mjl/images/google-calendar-step-6.png)

5. Make attributes for all 5 of the needed attributes. They are:
   1. Summary
   2. Description
   3. Start Time
   4. End Time
   5. Email
6. Repeat the process until all required attributes are created.

***

### Step 4: Add Google Calendar Actions to Agent

1. In the Agent Instructions editor, type a backslash (`/`) in the Agent Actions search bar.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/PPWuLeGWFl2dyl2ODlDz/images/google-calendar-step-7.png)

2. Search for Google Calendar and select the required action (e.g., *Google Calendar Create Event*).

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/npJJ4MwE6z2OQkrTmERX/images/google-calendar-step-8.png)

3. Choose the credentials/configuration (Google account) to link with this action.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/2eSuYVwAkku59ybjRpK7/images/google-calendar-step-9.png)

***

### Step 5: Map Data Fields

In the **Configuration screen**:

1. For each Google Calendar field (Summary, Description, Start Time, End Time, Email), map it to the **corresponding custom attribute** you created earlier.

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/JU3tHl6LiDfdt1coxT3U/images/google-calendar-step-10.png)

2. Leave **Fallback Values** empty unless a default is required.

***

### Step 6: Test the Integration

In the **Test screen**, provide sample data for all five fields:

**Example:**

* Summary: *Product Demo*
* Description: *30-min walkthrough of features*
* Start Time: 2025-09-19T17:30:00+08:00
* End Time: 2025-09-19T17:30:00+09:00
* Email: [*client@example.com*](mailto:client@example.com)

Click **Test Data**.

* If successful, the event will be created in Google Calendar.
* If failed, an error message will appear explaining the issue (e.g., invalid time format).

![](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/4jbesSgYj1KfRsVI4ipt/images/google-calendar-step-11.png)

***

### Step 7: Deploy

1. Once the test passes, click **Finish**.

***

## **Frequently Asked Questions (FAQs)**

<details>

<summary>Do I need a Google account to use the integration?</summary>

Yes. You must have a valid Google account with access to Google Calendar in order to connect and sync with BotPenguin’s AI Agent.

</details>

<details>

<summary>Can I connect multiple Google Calendar accounts?</summary>

Yes. You can integrate multiple Google Calendar accounts. Each account will appear as a separate configuration under the integration settings.

</details>

<details>

<summary>What happens if I disable a configuration?</summary>

Disabling a configuration will temporarily stop event syncing for that account. You can re-enable it anytime by toggling the status back on.

</details>

<details>

<summary>Is it mandatory to create custom attributes?</summary>

Yes. Custom attributes are required to capture user inputs (like event title, date, or participants). Without these attributes, the AI Agent cannot create or manage events in Google Calendar.

</details>

<details>

<summary>Can the AI Agent manage existing events in my calendar?</summary>

Currently, the integration focuses on creating new events based on user input. Managing or editing existing events is subject to the permissions you grant during integration.

</details>

<details>

<summary>What happens if the Google token expires?</summary>

If the Google token expires, you will need to re-authenticate by reconnecting your Google account from the integration settings.

</details>

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.
