Connect ChatGPT to Google Calendar: A Step-by-Step Guide to Building Your Own GPT Action

Want to create events, check appointments, or even delete entries directly from ChatGPT? This guide shows you how to build a GPT Action for Google Calendar, connecting ChatGPT's natural language processing with your personal calendar. You'll be able to use conversational commands to manage your schedule, making planning and organization easier than ever.

Why Connect ChatGPT to Your Google Calendar?

Imagine effortlessly managing your schedule using simple voice commands. Here's why connecting ChatGPT to your Google Calendar is a game-changer:

Seamless Scheduling: Create new events in your calendar by simply describing them to ChatGPT.
Effortless Information Retrieval: Quickly search for events based on specific criteria—no more manual scrolling.
Streamlined Management: Delete events with ease, directly through your ChatGPT interface.

Prerequisites: What You Need Before You Start

Before diving into the setup process, make sure you have:

A Google Account with access to Google Calendar.
Permissions to access the Google Calendar API and use the Google Cloud Console to configure OAuth credentials.

Step-by-Step: Configuring Your Google Calendar API

Let's get your Google Calendar ready for the GPT Action.

1. Enabling the Google Calendar API

Go to console.cloud.google.com.
Select your project. If you don't have one, create a new project.
Navigate to APIs & Services > Library.
Search for Google Calendar API and click on it.
Click the Enable button.

2. Creating OAuth Credentials

OAuth credentials will allow your GPT Action to securely access your Google Calendar.

In the left menu, click Credentials.
Click Configure consent screen.
Enter your app name and choose your email in the User support email dropdown.
Choose Internal audience and enter a contact email.
Agree to the terms and click Create.
Click Create OAuth Credentials and choose Web Application.
Enter your application name.
Under Authorized JavaScript Origins, enter https://chat.openai.com & https://chatgpt.com.
Leave the "Authorized redirect URIs" blank for now.
Click Create. The OAuth client ID and client secret will be displayed.

3. Configuring OAuth Scopes

Scopes define which services your OAuth client ID can access.

In the left menu, click Data Access.
Click Add or Remove Scopes.
Filter on https://www.googleapis.com/auth/calendar.
Choose the first result (ending with /auth/calendar).
Click Update and then Save.

Step-by-Step: Configuring Your GPT Action

Now that your Google Calendar is set up, let's configure the GPT Action.

1. OAuth Settings

These settings enable the GPT to authenticate with Google Calendar.

In your GPT, create an action.
Click the settings gear icon and select OAuth.
Enter the Client ID and Client Secret from the Google Cloud Console.
Enter the following details:
- Authorization URL: https://accounts.google.com/o/oauth2/auth
- Token URL: https://oauth2.googleapis.com/token
- Scopes: https://www.googleapis.com/auth/calendar
Leave the Token Exchange Method as default.
Click Save.

2. OpenAPI Schema

This schema defines the capabilities of your Google Calendar API integration.

Copy and paste the following OpenAPI schema into the designated field:

openapi: 3.1.0
info:
  title: Google Calendar API
  description: This API allows you to read and create events in a user's Google Calendar.
  version: 1.0.0
servers:
  - url: https://www.googleapis.com/calendar/v3
    description: Google Calendar API server

paths:
  /calendars/primary/events:
    get:
      summary: List events from the primary calendar
      description: Retrieve a list of events from the user's primary Google Calendar.
      operationId: listEvents
      tags:
        - Calendar
      parameters:
        - name: timeMin
          in: query
          description: The lower bound (inclusive) of the events to retrieve, in RFC3339 format.
          required: false
          schema:
            type: string
            format: date-time
            example: "2024-11-01T00:00:00Z"
        - name: timeMax
          in: query
          description: The upper bound (exclusive) of the events to retrieve, in RFC3339 format.
          required: false
          schema:
            type: string
            format: date-time
            example: "2024-12-01T00:00:00Z"
        - name: maxResults
          in: query
          description: The maximum number of events to return.
          required: false
          schema:
            type: integer
            default: 10
        - name: singleEvents
          in: query
          description: Whether to expand recurring events into instances. Defaults to `false`.
          required: false
          schema:
            type: boolean
            default: true
        - name: orderBy
          in: query
          description: The order of events. Can be "startTime" or "updated".
          required: false
          schema:
            type: string
            enum:
              - startTime
              - updated
            default: startTime
      responses:
        '200':
          description: A list of events
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The event ID
                        summary:
                          type: string
                          description: The event summary (title)
                        start:
                          type: object
                          properties:
                            dateTime:
                              type: string
                              format: date-time
                              description: The start time of the event
                            date:
                              type: string
                              format: date
                              description: The start date of the all-day event
                        end:
                          type: object
                          properties:
                            dateTime:
                              type: string
                              format: date-time
                              description: The end time of the event
                            date:
                              type: string
                              format: date
                              description: The end date of the all-day event
                        location:
                          type: string
                          description: The location of the event
                        description:
                          type: string
                          description: A description of the event
        '401':
          description: Unauthorized access due to missing or invalid OAuth token
        '400':
          description: Bad request, invalid parameters

    post:
      summary: Create a new event on the primary calendar
      description: Creates a new event on the user's primary Google Calendar.
      operationId: createEvent
      tags:
        - Calendar
      requestBody:
        description: The event data to create.
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                summary:
                  type: string
                  description: The title of the event
                  example: "Team Meeting"
                location:
                  type: string
                  description: The location of the event
                  example: "Conference Room 1"
                description:
                  type: string
                  description: A detailed description of the event
                  example: "Discuss quarterly results"
                start:
                  type: object
                  properties:
                    dateTime:
                      type: string
                      format: date-time
                      description: Start time of the event
                      example: "2024-11-30T09:00:00Z"
                    timeZone:
                      type: string
                      description: Time zone of the event start
                      example: "UTC"
                end:
                  type: object
                  properties:
                    dateTime:
                      type: string
                      format: date-time
                      description: End time of the event
                      example: "2024-11-30T10:00:00Z"
                    timeZone:
                      type: string
                      description: Time zone of the event end
                      example: "UTC"
                attendees:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                        description: The email address of an attendee
                        example: "[email protected]"
              required:
                - summary
                - start
                - end
      responses:
        '201':
          description: Event created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The ID of the created event
                  summary:
                    type: string
                    description: The event summary (title)
                  start:
                    type: object
                    properties:
                      dateTime:
                        type: string
                        format: date-time
                        description: The start time of the event
                  end:
                    type: object
                    properties:
                      dateTime:
                        type: string
                        format: date-time
                        description: The end time of the event
        '400':
          description: Bad request, invalid event data
        '401':
          description: Unauthorized access due to missing or invalid OAuth token
        '500':
          description: Internal server error

3. Setting the Callback URL

ChatGPT will generate a callback URL that needs to be added to the Authorized redirect URIs in the Google Cloud Console.

Exit the action configuration screen in ChatGPT and scroll to the bottom to find the generated callback URL.
Copy this URL and add it to the Authorized redirect URIs in the Google Cloud Console, then click Save.

Testing Your New ChatGPT Google Calendar Integration

Now comes the fun part: making sure your setup is working:

Ask your GPT a test question, for example: "What events do I have today?".
If this is the first time you've used the action, you'll be prompted to authorize it. Click "Sign in with googleapis.com" and follow the prompts.
Once authorized, you should see the results from your calendar.

Congratulations! You've successfully connected ChatGPT to your Google Calendar. Now you can enjoy effortless schedule management through the power of natural language.

Take your Calendar GPT Action even further

Now that you have a working action, consider these enhancements for a more personalized experience:

Let ChatGPT know about your common meetings and preferred times to schedule new events using knowledge.
Integrate GPT with other apps, making the Google Calendar API connection a single step in a multistep automation.