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.

Setup

Connect the Google Calendar toolkit to your Google account 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 to Google

  1. Navigate to your MCP server panel in the toolforest.io dashboard
  2. Locate the Google Calendar toolkit
  3. Click Connect
  4. 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.

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 the Disconnect button in your MCP server panel
  2. toolforest.io will remove all stored access tokens
🔒 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), 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