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

# Google Calendar Toolset

> Calendar and scheduling integration for AI agents

<div className="max-w-2xl mx-auto mt-12">
  <div className="p-6 border border-gray-200 dark:border-gray-700 rounded-lg bg-blue-50 dark:bg-gray-800">
    <div className="flex items-center mb-4">
      <img src="https://mintcdn.com/pipeshub/4rmVczZEgCVV6or_/logo/gcalendar.png?fit=max&auto=format&n=4rmVczZEgCVV6or_&q=85&s=fc11562033409f426a7bf609ae02f26f" alt="Google Calendar Logo" className="w-8 h-8 mr-3 object-contain flex-shrink-0" width="96" height="96" data-path="logo/gcalendar.png" />

      <h2 className="text-2xl font-semibold m-0">Google Calendar Toolset</h2>
    </div>

    <p className="text-lg text-gray-700 dark:text-gray-300 mb-4">Calendar and event management</p>

    <div className="flex items-center gap-2">
      <span className="px-3 py-1 bg-yellow-100 dark:bg-yellow-900 text-yellow-800 dark:text-yellow-200 rounded-full text-sm font-medium">
        Documentation in Progress
      </span>

      <span className="px-3 py-1 bg-purple-100 dark:bg-purple-900 text-purple-800 dark:text-purple-200 rounded-full text-sm font-medium">
        Google Workspace
      </span>
    </div>
  </div>
</div>

## Overview

The Google Calendar toolset enables AI agents to manage calendar events and scheduling.

### Key Capabilities

* View upcoming events and schedules
* Create and schedule new events
* Update and delete existing events
* Create Google Meet links for events
* Manage multiple calendars

***

## Available Tools

| Tool                      | What it does                                                |
| ------------------------- | ----------------------------------------------------------- |
| `get_calendar_events`     | Get upcoming calendar events                                |
| `create_calendar_event`   | Create a new calendar event                                 |
| `update_calendar_event`   | Update a calendar event                                     |
| `create_meet_link`        | Create a Google Meet link and attach it to a calendar event |
| `delete_calendar_event`   | Delete a calendar event                                     |
| `get_calendar_list`       | List all calendars                                          |
| `get_calendar_list_by_id` | Get a specific calendar by ID                               |

***

## Setup

<AccordionGroup>
  <Accordion title="Setup" icon="gear">
    ### Step 1: Create Google Cloud Project

    1. Go to [Google Cloud Console](https://console.cloud.google.com/)
    2. Create a new project or select an existing one
    3. Note your project ID

    ### Step 2: Enable Google Calendar API

    1. Navigate to **APIs & Services > Library**
    2. Search for **"Google Calendar API"**
    3. Click **"Enable"**

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/4ycUuVjJb28yuV3m/images/connectors/googleWorkspace/enterprise/apis.png?fit=max&auto=format&n=4ycUuVjJb28yuV3m&q=85&s=ebc4344eb0cae21e37c6cbeb2cd4dde5" alt="Enable Calendar API" className="block mx-auto w-11/12" width="1847" height="1092" data-path="images/connectors/googleWorkspace/enterprise/apis.png" />
    </div>

    ### Step 3: Configure OAuth Consent Screen

    1. Navigate to **APIs & Services > OAuth consent screen**
    2. Configure the OAuth consent screen with your app information
    3. Add the required scopes (see Step 6)

    ### Step 4: Get Redirect URI from PipesHub

    1. In PipesHub, go to **Settings > Toolsets**
    2. Find **Calendar** and click **"Configure"**
    3. Copy the **Redirect URI** shown in the dialog

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/CB4tzc9xyu8XG-4X/images/toolsets/calendar/pipeshub-config.png?fit=max&auto=format&n=CB4tzc9xyu8XG-4X&q=85&s=6faaf6cf5e2f4502122f600bffeb333c" alt="Copy Redirect URI from PipesHub" className="block mx-auto w-11/12" width="1914" height="909" data-path="images/toolsets/calendar/pipeshub-config.png" />
    </div>

    ### Step 5: Create OAuth Client ID

    1. Navigate to **APIs & Services > Credentials**
    2. Click **"Create Credentials"** > **"OAuth client ID"**
    3. Select **"Web application"**
    4. Set the **Authorized redirect URI** to the URI from PipesHub
    5. Click **"Create"**
    6. Copy your **Client ID** and **Client Secret**

    <Info>
      The redirect URI must match exactly your PipesHub URL.
    </Info>

    ### Step 6: Add Required Scopes

    Add these OAuth scopes in the **OAuth consent screen > Scopes** section:

    **Required Scopes:**

    * `https://www.googleapis.com/auth/calendar` - Full calendar access
    * `https://www.googleapis.com/auth/calendar.events` - Manage events
    * `https://www.googleapis.com/auth/gmail.send` - Send calendar invites and notifications

    ### Step 7: Configure in PipesHub

    1. Return to the PipesHub Calendar configuration dialog
    2. Enter your **Client ID** and **Client Secret**
    3. Click **"Authenticate"**

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/CB4tzc9xyu8XG-4X/images/toolsets/calendar/enter-credentials.png?fit=max&auto=format&n=CB4tzc9xyu8XG-4X&q=85&s=9047f2765badf268499dc60efc0ff9de" alt="Enter Credentials in PipesHub" className="block mx-auto w-11/12" width="1919" height="910" data-path="images/toolsets/calendar/enter-credentials.png" />
    </div>

    ### Step 8: Authorize Access

    1. A popup will open to Google's consent screen
    2. Sign in and grant permission for Calendar access
    3. Click **"Allow"**

    <div className="text-center">
      <img src="https://mintcdn.com/pipeshub/4ycUuVjJb28yuV3m/images/connectors/googleWorkspace/individual/gmail_consent_screen.png?fit=max&auto=format&n=4ycUuVjJb28yuV3m&q=85&s=5a1cfb329d8effbc6987e2404297a383" alt="Google Consent Screen" className="block mx-auto w-11/12" width="1907" height="1020" data-path="images/connectors/googleWorkspace/individual/gmail_consent_screen.png" />
    </div>

    4. You'll be redirected back to PipesHub
    5. The toolset will show **"Authenticated"** status
  </Accordion>
</AccordionGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="What's the difference between Calendar Connector and Calendar Toolset?">
    | Aspect          | Calendar Connector                        | Calendar Toolset                                |
    | --------------- | ----------------------------------------- | ----------------------------------------------- |
    | **Purpose**     | Sync and index calendar events for search | Enable agents to perform calendar actions       |
    | **Data Flow**   | One-way (import data into PipesHub)       | Two-way (read and write via API)                |
    | **When to Use** | Query/search events and meetings          | Create events, update meetings, manage calendar |

    **Example:** Use **Calendar Connector** to search past and upcoming events. Use **Calendar Toolset** to let agents schedule meetings or update event details.
  </Accordion>
</AccordionGroup>

***

## Usage Tips

**How do I create an event?**\
Ask your agent to "schedule a meeting" and provide the date, time, title, and attendees. For example: "schedule a team meeting tomorrow at 2pm with [john@example.com](mailto:john@example.com)".

**How do I update an event?**\
Ask to "move my 2pm meeting to 3pm" or "add [sarah@example.com](mailto:sarah@example.com) to the team meeting". The agent will find and update the event.