kaien
DOCS

Connecting Google Calendar.

What kaien reads, what it writes, and how to fix it when something goes wrong.

What we read

kaien reads your Google Calendar to check for conflicts. When a guest tries to book a slot, we check whether you already have an event marked as Busy at that time. If you do, the slot is hidden from the booking page.

We only read the calendar you select during setup. We don't read other calendars in your Google account, and we don't read the content of your events — only their time and busy/free status.

What we write

When someone books a meeting, kaien creates a calendar event on your behalf with:

  • The event title (e.g. “30-min intro call with Priya”)
  • The start and end time
  • The guest's name and email as an attendee
  • A Google Meet link (if you have Meet enabled in your Google Calendar settings)
  • Any notes or questions the guest filled in at booking time

If a booking is cancelled or rescheduled, kaien updates or deletes the calendar event accordingly.

Permissions we request

We request the https://www.googleapis.com/auth/calendar.events scope, which allows us to create, update, and delete events on your calendar. We do not request access to your Gmail, Drive, or any other Google service.

If the connection breaks

Google OAuth tokens can expire or be revoked. If kaien loses access to your calendar, you'll see a warning banner in your dashboard. To fix it:

  1. Go to Settings → Calendar in kaien.
  2. Click Reconnect Google Calendar.
  3. Complete the Google OAuth flow again.

If you revoked access from your Google account security settings, you'll need to reconnect from kaien as well. Go to myaccount.google.com/permissions to see which apps have access to your Google account.

Switching calendars

If you want to use a different Google Calendar (e.g. a work calendar instead of personal), go to Settings → Calendar, disconnect the current calendar, and reconnect with the account you want to use.

Calendar not syncing correctly? Email founder@getkaien.com — we usually reply within a day.

← Back to Docs