Google Calendar Integration

Enable 2-way synchronization between Kairos and Google Calendar using the Google Cloud Platform (GCP).

Why Google Cloud?

Kairos uses the official Google Calendar API to ensure reliability and security. You need to create your own OAuth credentials so that you own the connection, and no third-party service sits between you and your data.

1. Create GCP Project

  1. Go to the Google Cloud Console.
  2. Create a new project (e.g., "Kairos Personal").
  3. Navigate to APIs & Services → Library.
  4. Search for and enable the Google Calendar API.

2. Configure Consent Screen

Go to APIs & Services → OAuth consent screen.

  • User Type: External (unless you have a Workspace organization).
  • App Name: Kairos
  • User Support Email: Your email.
  • Test Users: Add your own email address here (crucial for External apps).

Required Scopes

.../auth/calendar.../auth/userinfo.email

3. Create OAuth Credentials

Go to Credentials → Create Credentials → OAuth Client ID.

  • Application TypeWeb application
  • Authorized JavaScript Originshttp://localhost:3000
  • Authorized Redirect URIshttp://localhost:8000/auth/callback

Copy the Client ID and Client Secret into your cortex/.env file.

Next: Architecture