Google Calendar

Documentation Index

Fetch the complete documentation index at: https://docs.major.build/llms.txt

Use this file to discover all available pages before exploring further.

​

Setup

1. Go to Organization Settings > Connectors
2. Click Add Connector and select Google Calendar
3. Choose the access scope:
   • Read only — Can list and read calendar events
   • Read and write — Can list, read, and create calendar events
4. Choose the authentication mode:
   • Shared — Use a single shared account (the person configuring the resource provides credentials)
   • Per-user — Each app user connects their own account
5. Click Connect to Google to authorize access
6. Select the calendar you want to connect (or skip if using per-user auth — users will select their own)

​

Per-User Authentication

​

User Flow

1. User accesses a deployed app that uses a per-user Google Calendar resource
2. If they haven’t connected their account, Major redirects them to the /connect page
3. User clicks Connect Google Calendar and authorizes access to their own calendar
4. User is returned to the app and can now use Google Calendar features

​

Managing Connections

​

Usage

import { googlecalendarClient } from './clients';

​

Listing calendars

const result = await googlecalendarClient.googlecalendar_list_calendars(
  'list-calendars'
);

if (result.ok) {
  const calendars = result.result.items;
  calendars.forEach(cal => {
    console.log(cal.id, cal.summary);
  });
}

• operationName — A name for logging and debugging

• items — Array of calendar objects with id, summary, description, and other metadata

​

Listing events

const result = await googlecalendarClient.googlecalendar_list_events(
  'list-events',
  {
    calendarId: 'primary',
    maxResults: 10,
    orderBy: 'startTime',
    singleEvents: true,
    timeMin: '2024-01-01T00:00:00Z',
    timeMax: '2024-12-31T23:59:59Z'
  }
);

if (result.ok) {
  const events = result.result.items;
  events.forEach(event => {
    console.log(event.summary, event.start.dateTime);
  });
}

• operationName — A name for logging and debugging
• options — Query options:
  • calendarId — Calendar identifier (default: primary)
  • maxResults — Maximum events to return (1–250)
  • orderBy — Sort order: startTime or updated
  • singleEvents — Expand recurring events into instances (default: false)
  • timeMin — Lower bound (RFC 3339 format)
  • timeMax — Upper bound (RFC 3339 format)
  • q — Search query term

• items — Array of event objects with id, summary, start, end, and other metadata

​

Creating events

const result = await googlecalendarClient.googlecalendar_create_event(
  'create-event',
  {
    calendarId: 'primary',
    summary: 'Team Meeting',
    description: 'Quarterly planning session',
    start: {
      dateTime: '2024-02-15T14:00:00',
      timeZone: 'America/New_York'
    },
    end: {
      dateTime: '2024-02-15T15:00:00',
      timeZone: 'America/New_York'
    },
    attendees: [
      { email: 'alice@example.com' },
      { email: 'bob@example.com' }
    ]
  }
);

if (result.ok) {
  console.log('Event created:', result.result.id);
}

• operationName — A name for logging and debugging
• eventBody — Event object with:
  • summary — Event title (required)
  • description — Event description
  • start — Start time with dateTime and optional timeZone
  • end — End time with dateTime and optional timeZone
  • attendees — Array of attendee objects with email
  • location — Event location
  • recurrence — Recurrence rules (RFC 5545 format)

• id — The created event’s ID
• htmlLink — Link to the event in Google Calendar
• Full event object with all details

​

Low-level API

const result = await googlecalendarClient.googlecalendar_invoke(
  'GET',
  '/calendars/primary/events',
  'list-events',
  {
    query: { maxResults: 10 }
  }
);

​

Supported API paths

​

Error handling

import { ResourceInvokeError } from '@major-tech/resource-client';

try {
  const result = await googlecalendarClient.googlecalendar_list_events(
    'list-events',
    { calendarId: 'primary' }
  );

  if (!result.ok) {
    // Resource returned an error (e.g., calendar not found)
    console.error('Calendar error:', result.error.message);
    return;
  }

  // Success
  console.log(result.result.items);

} catch (e) {
  if (e instanceof ResourceInvokeError) {
    // Client-level error (e.g., OAuth not completed)
    console.error('Invocation error:', e.message);
  }
}

​

Common errors

​

Scope and permissions

• Read only — GET requests only
• Read and write — Full read/write access including event creation and deletion