Work in Progress These docs are a work in progress. More content is coming soon.

← Back to Documentation

Google Calendar

Manage your calendar with AI assistance. View, create, and organize events, check availability, and RSVP to invitations.

Tool Reference: 15 tools with full schemas →

Setup

Connect the Google Calendar toolkit to one or more Google accounts to allow your AI assistant to view, create, and manage your calendar events.

Prerequisites

Before connecting Google Calendar, ensure you have configured an MCP server in your toolforest.io dashboard.

Setup Steps

Step 1: Connect a Google Account

  1. Open Toolforest and go to Toolkits.
  2. Select the Google Workspace tab.
  3. Find Google Calendar.
  4. Click Connect.
  5. Choose the Google account you want this toolkit to use, or select Use another account.
  6. You’ll be redirected to Google’s authorization page.

Important: The Google account you connect doesn’t need to match your toolforest.io email address.

Step 2: Authorize Permissions

Google will ask you to grant toolforest.io the following permissions:

  • View and edit events on all your calendars – Allows toolforest.io to create, update, and delete calendar events
  • View your calendars – Allows toolforest.io to list your calendars
  • View free/busy information – Allows toolforest.io to check availability across calendars
  • View your email address – Allows toolforest.io to identify your account

Click Continue to grant these permissions.

Step 3: Confirmation

After authorizing, you’ll be redirected back to toolforest.io with a “Successful connection” message. The toolkit status will now show Connected.

Step 4: Optionally Connect Additional Accounts

The first connected Google account is marked as the default account for this toolkit. If you want to use another Google account as well, click Manage accounts next to the toolkit, then choose Add another Google account.

When your AI assistant calls a Google Calendar tool, the default account is used unless the tool call specifies a different account.

Understanding Permissions

What toolforest.io Can Access

toolforest.io’s permissions allow your AI assistant to:

  • Read calendars: View your list of calendars and their settings
  • Manage events: Create, update, and delete events on your behalf
  • Check availability: Query free/busy information across your calendars
  • RSVP: Respond to event invitations

Data Privacy

Your calendar data is retrieved only when you explicitly ask your LLM to query it. toolforest.io does not store your calendar data permanently; it acts as a bridge to fetch the specific information your assistant needs to answer your questions.

Managing Your Connection

Disconnect

To disconnect the toolkit:

  1. Click Manage accounts next to the toolkit
  2. Click Disconnect for the Google account you want to remove
  3. To remove every connected account for the toolkit, disconnect each account in the list
  4. toolforest.io will remove the stored access tokens for disconnected accounts
🔒 Note
Disconnecting removes toolforest.io's access tokens but does not automatically revoke permissions in your Google account. The toolkit will require reauthorization to connect again.

Revoke Permissions

To fully revoke toolforest.io’s access to your Google account:


Capabilities

CategoryCapabilities
PermissionsView granted OAuth scopes, email address, primary timezone
CalendarsList all calendars (owned, subscribed, shared), view color palette for events and calendars
EventsSearch with text and time filters, get full event details, create with attendees/recurrence/Google Meet links, update (patch semantics), set colors/visibility/transparency, soft delete
Recurring EventsList instances in time range, update single instances as exceptions without affecting the series
SchedulingCheck free/busy across calendars, find open meeting slots with working-hours support, quick-add events with natural language
RSVPAccept, decline, or tentatively respond to event invitations with configurable notification preferences