Skip to main content
FeaturesPricingDocsBlogAbout
Download for Mac

Calendar Integration

Connect your calendar so Karnyx can automatically detect meetings, import attendees, and build pre-meeting context for every conversation.

Google Calendar Setup

  1. Open Settings > Integrations > Calendar in the Karnyx app.
  2. Click "Connect Google Calendar".
  3. A browser window opens for Google OAuth. Sign in with your Google Workspace or personal account.
  4. Review the permissions and click "Allow".
  5. Return to the Karnyx app. Your calendar will begin syncing immediately.

Permissions Requested

ScopePurpose
calendar.events.readonlyRead your calendar events, times, and attendees
calendar.settings.readonlyDetect your time zone and calendar preferences
userinfo.emailMatch your identity across meeting platforms

Read-Only Access

Karnyx never creates, modifies, or deletes calendar events. All access is strictly read-only.

Outlook Calendar Setup

  1. Open Settings > Integrations > Calendar in the Karnyx app.
  2. Click "Connect Outlook Calendar".
  3. Sign in with your Microsoft work or school account. Personal Outlook.com accounts are also supported.
  4. Your IT admin may need to pre-approve the Karnyx app in Azure AD for managed accounts.
  5. Authorize the requested permissions and return to the app.

Azure AD Approval May Be Required

If your organization restricts third-party app access, an Azure AD admin must grant tenant-wide consent for the Karnyx application. Contact your IT department if you see a "Need admin approval" screen.

What Syncs

Once connected, Karnyx pulls the following data from each calendar event:

DataUsed ForStored
Event titleMeeting naming, searchYes
Start/end timeAutomatic capture triggeringYes
Attendee listParticipant graph, pre-meeting briefingsYes
Meeting join URLBot Mode auto-join, platform detectionEncrypted
Event descriptionAgenda extraction for contextOptional

30-Day Cold-Start Hydration

When you first connect your calendar, Karnyx imports the past 30 days of events in addition to your upcoming schedule. This serves several purposes:

  • Participant graph seeding: Pre-populates your contact relationships based on who you have met recently.
  • Pre-meeting context: When you have an upcoming meeting with someone, Karnyx can reference your past meetings even before it captured any audio.
  • Meeting patterns: Detects your recurring meetings and weekly rhythms.

Hydration is Fast

The 30-day import typically completes in under 30 seconds. You will see a progress indicator in the app sidebar while it runs.

Troubleshooting

Calendar is not syncing after connection

Try disconnecting and reconnecting the calendar in Settings > Integrations. Ensure your browser did not block the OAuth redirect. Check that third-party cookies are enabled for the OAuth flow.

"Need admin approval" error (Outlook)

Your organization's Azure AD policy requires an administrator to grant consent. Share the Karnyx admin consent link with your IT team: they can approve the app from the Azure AD Enterprise Applications portal.

Some events are missing attendees

If attendees were added after the initial sync, Karnyx will pick them up on the next sync cycle (every 5 minutes). For immediate updates, click the refresh button on the meeting detail page.

Private events are not appearing

By default, Karnyx respects the "private" flag on calendar events and will not import them. You can enable private event import in Settings > Privacy > Calendar.

Getting StartedSlack & Teams