Skip to main content
Google Calendar Logo
Google Calendar Toolset

Calendar and event management

ReadyGoogle Workspace

​
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

​
Setup

​
Step 1: Create Google Cloud Project

  1. Go to Google Cloud Console
  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”
Enable Calendar API
  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 Novaplan AI

  1. In Novaplan AI, open Workspace Settings → Actions.
  2. Find Calendar and choose + Setup or Configure.
  3. Copy the Redirect URI shown in the dialog
Copy Redirect URI from Novaplan AI

​
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 Novaplan AI
  5. Click “Create”
  6. Copy your Client ID and Client Secret
The redirect URI must match exactly your Novaplan AI URL.

​
Step 6: Add Required Scopes

Add these OAuth scopes in the OAuth consent screen > Scopes section:Scopes requested by the accessible toolset implementation:
  • 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 - Gmail send permission requested by the implementation
The accessible Calendar tools send invitations through the Calendar API’s sendUpdates option; they do not call the Gmail API. Google’s event creation and event update references list Calendar scopes for those calls, not gmail.send. The accessible implementation still requests gmail.send. Ask Novaplan to confirm or remove that extra request in the deployed Enterprise toolset before approving it.

​
Step 7: Configure in Novaplan AI

  1. Return to the Novaplan AI Calendar configuration dialog
  2. Enter your Client ID and Client Secret
  3. Click “Authenticate”
Enter Credentials in Novaplan AI

​
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”
Google Consent Screen
  1. You’ll be redirected back to Novaplan AI
  2. The toolset will show “Authenticated” status

​
FAQ

Example: Use Calendar Connector to search past and upcoming events. Use Calendar Toolset to let agents schedule meetings or update event details.

​
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”. How do I update an event?
Ask to “move my 2pm meeting to 3pm” or “add sarah@example.com to the team meeting”. The agent will find and update the event. To move an event, give both the new start and end times. With only one, the event remains unchanged and the agent asks for both. Which time zone should I use? Include the time zone when it matters, such as “10:00 Europe/Berlin”. A time without an offset uses the time zone supplied with the event, or UTC if none is supplied. Invalid time zones and an end before the start are refused. A one-day all-day event covers the requested date in its time zone. What if an action fails? The agent reports whether Google is rate-limiting, sign-in needs renewal, or permission is missing. If creating an event succeeds but reading back its meeting link fails, the agent reports that the event exists so it is not created twice.