Google Calendar

The Google Calendar integration lets your AI agents manage your calendar. Agents can create events, list upcoming meetings, invite attendees, and automatically generate Google Meet video links.

Connecting Google Calendar

1. Go to Settings > Integrations.
2. Click Connect next to Google Calendar.
3. Sign in with your Google account and grant VectorChat access.
4. You'll be redirected back to VectorChat once the connection is complete.

VectorChat uses OAuth 2.0 with PKCE for secure authorization. Tokens are encrypted and automatically refreshed.

What Agents Can Do

Create Events

• Create a calendar event -- Specify a title, start time, end time, description, location, and attendees. Times use RFC 3339 format with timezone support.
• Quick add -- Create an event from natural language, like "Lunch with Sam tomorrow at 1pm." Google interprets the text to set the event details automatically.

Google Meet Links

By default, new events include a Google Meet video conferencing link. The agent will include the Meet link in its response when an event is created. You can disable this by telling the agent you don't need a video link.

View Events

• List events -- View events within a time window. Supports filtering by calendar, date range, and sort order. Recurring events are automatically expanded into individual occurrences.
• Get event details -- Retrieve full details for a specific event by its ID.

Manage Events

• Update an event -- Change the title, description, location, times, or attendees of an existing event. You can also add a Google Meet link to an event that doesn't have one.
• Invite attendees -- Add attendees to an existing event. You can append to the existing attendee list or replace it entirely.
• Notification control -- Choose whether to send email notifications to attendees when events are created or updated (all, external only, or none).

Multiple Calendars

By default, agents work with your primary calendar. You can specify a different calendar by providing its calendar ID when asking the agent to create or list events.

Timezones

If you don't specify a timezone in your request, the integration defaults to Europe/Zurich. You can include an IANA timezone identifier (like America/New_York or Asia/Tokyo) in your request to use a different timezone.

Disconnecting

Go to Settings > Integrations, find Google Calendar, and click Disconnect. This removes your stored credentials and prevents agents from accessing your calendar.