Skip to main content

Signing In and Connecting Your Calendar

Connect your calendar so Harmony can show upcoming meetings, identify attendees, and (when enabled at every layer) schedule the Companion Bot for qualifying events.

Sign in to Harmony​

The two sign-in methods that are functional today are email + password and Google sign-in (where Google is enabled for your domain).

  1. Go to heyharmony.com and click Sign In.
  2. Sign in with email and password, or click Continue with Google.

Harmony's sign-in screen may show buttons for Microsoft, Apple, or SAML-based corporate SSO, but only Google sign-in is functional today in self-serve. The other buttons are placeholders for future functionality and do not currently complete authentication. Enterprise SAML SSO is configured separately as part of an enterprise contract — contact your account team if you need it.

Connect Google Calendar​

Connecting your calendar lets Harmony display upcoming meetings, identify participants, and find supported video links. Harmony's calendar integration today supports Google Calendar only — there is no native Outlook, Microsoft 365, or iCloud calendar integration.

  1. Open Marketplace from the workspace sidebar.
  2. On the Apps tab, find Google Calendar and click Connect.
  3. Sign in to your Google account and click Allow to grant permissions.
  4. Select the specific calendars you want to sync with Harmony.

Privacy and calendar access: Harmony uses calendar event metadata (titles, times, attendee emails, meeting links) so it can show your schedule and prepare recordings. Access depends on the permissions you approve in the Google authorisation flow.

Add Harmony to your meetings​

There are two ways the Companion Bot can join a meeting: manually (you paste a link) or auto-join (Harmony schedules the bot from your calendar).

Manual join (always available)​

  1. Copy your meeting link from your meeting platform.
  2. Open Quick Launch (the Cmd/Ctrl+K command palette) or the Meetings area.
  3. Select Remote.
  4. Paste the link and click Ask Companion to join.
  5. Admit the Companion Bot from the meeting's waiting room if prompted.

Auto-join (gated by several layers)​

Auto-join is not a single toggle. For an event to be auto-joined, all of the following must be true:

  • The bot-auto-join Reflag feature flag is on for your deployment.
  • The backend env kill-switch HARMONY_REMOTE_AUTOJOIN is set to "true".
  • Your workspace admin has enabled auto-join (Workspace Settings → Experimental).
  • Your User Preferences → Experimental auto-join setting is on.
  • Your calendar is connected and syncing.
  • The event has a supported Zoom, Google Meet, or Microsoft Teams link.
  • The event starts in the supported scheduling window — between 2 minutes and 28 days in the future.

If any layer is off, you can still send the Companion manually as above. For the full layered model and troubleshooting, see Recording automatically.

For step-by-step coverage of your first recording, see Your first meeting with Harmony.