Google Calendar

Create events, check availability, manage schedules, and coordinate meetings.

You have access to Google Calendar through the OpenLabor connector API.

How to Execute Calendar Actions

use google_calendar <TOOL_NAME> '<json_args>'

Events

Create an Event

• Tool: GOOGLECALENDAR_CREATE_EVENT
• Args: { "summary": "Team Meeting", "start_datetime": "2026-03-25T10:00:00", "end_datetime": "2026-03-25T11:00:00", "timezone": "America/New_York" }
• Optional: "description", "location", "attendees" (array of emails)

Quick Add (natural language)

• Tool: GOOGLECALENDAR_QUICK_ADD
• Args: { "text": "Lunch with Sarah tomorrow at noon" }

List Events

• Tool: GOOGLECALENDAR_FIND_EVENT
• Args: { "timeMin": "2026-03-22T00:00:00Z", "timeMax": "2026-03-29T00:00:00Z" }
• Optional: "query" (search text), "max_results", "order_by" ("startTime", "updated")

List Events Across All Calendars

• Tool: GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS
• Args: { "time_min": "2026-03-22T00:00:00Z", "time_max": "2026-03-29T00:00:00Z" }

Get Event Details

• Tool: GOOGLECALENDAR_EVENTS_GET
• Args: { "event_id": "EVENT_ID" }

Update an Event

• Tool: GOOGLECALENDAR_PATCH_EVENT
• Args: { "event_id": "EVENT_ID", "calendar_id": "primary", "summary": "Updated Title", "start_time": "2026-03-25T14:00:00", "end_time": "2026-03-25T15:00:00" }

Delete an Event

• Tool: GOOGLECALENDAR_DELETE_EVENT
• Args: { "event_id": "EVENT_ID" }

Move an Event to Another Calendar

• Tool: GOOGLECALENDAR_EVENTS_MOVE
• Args: { "event_id": "EVENT_ID", "calendar_id": "primary", "destination": "CALENDAR_ID" }

Remove an Attendee

• Tool: GOOGLECALENDAR_REMOVE_ATTENDEE
• Args: { "event_id": "EVENT_ID", "attendee_email": "person@example.com" }

Availability

Find Free Slots

• Tool: GOOGLECALENDAR_FIND_FREE_SLOTS
• Args: { "time_min": "2026-03-22T09:00:00Z", "time_max": "2026-03-22T18:00:00Z", "items": [{ "id": "primary" }] }

Get Current Date/Time

• Tool: GOOGLECALENDAR_GET_CURRENT_DATE_TIME
• Args: { "timezone": "America/New_York" }

Calendar Management

List Calendars

• Tool: GOOGLECALENDAR_LIST_CALENDARS
• Args: {}

Get Calendar Details

• Tool: GOOGLECALENDAR_GET_CALENDAR
• Args: { "calendar_id": "primary" }

Create a New Calendar

• Tool: GOOGLECALENDAR_DUPLICATE_CALENDAR
• Args: { "summary": "Marketing Calendar" }

Scheduling Best Practices

For Meetings

• Always check availability before suggesting times
• Include timezone in all datetime values
• Add agenda in the description field
• Set attendees to notify them automatically

For SDRs

• Check prospect's timezone before suggesting meeting times
• Offer 2-3 time slots
• Include meeting link and agenda in description
• Set reminders for follow-up

For Email Secretaries

• Manage the boss's calendar proactively
• Block focus time and buffer between meetings
• Coordinate across calendars for scheduling

Guidelines

1. Always use ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS)
2. Include timezone — don't assume UTC
3. Use "primary" as calendar_id for the main calendar
4. If you get a 400 "not connected" error, tell the user to connect Google Calendar in the Apps tab
5. Never expose credentials to the user