Skip to main content

Manage your integrations

Connect and configure external tools to give your Companion context and automation capabilities.

To access these settings, go to User preferences > Integrations.

Connect a new tool​

The Available Integrations section displays all supported platforms.

  1. Find the tool you want to connect (e.g., Linear, Google Calendar, or Notion).
  2. Click Connect.
  3. Follow the OAuth popup instructions to authorize Harmony.

Manage active connections​

Once connected, tools appear in the Active Integrations section at the top. You can fine-tune how each tool behaves, select specific data to sync, or troubleshoot connection issues.

  1. Locate the connected tool card.
  2. Click the three dots menu (⋮) in the top-right corner of the card.
  3. Select Manage to open the detailed configuration view.

Configuration: Calendars​

When managing Google Calendar, you control exactly which sub-calendars Harmony can see.

  • Toggle Calendars: Use the checkboxes to subscribe or unsubscribe from specific calendars (e.g., "Holidays," "Personal," or "Work").
  • Refresh List: If you created a new calendar in Google recently, click Refresh List to make it appear here.

Configuration: Task Tools (Linear)​

For project management tools like Linear, additional options ensure tasks are assigned correctly.

  • Sync Users: Maps your Linear team members to Harmony users. Run this if you added new people to your Linear team recently.
  • Update API Key: Allows you to rotate your credentials without deleting the entire integration.

Configuration: Contacts & CRMs​

Complex data tools like Google Contacts offer advanced synchronization settings to ensure data flows correctly between systems.

Sync Settings​

Navigate to the Sync tab to control automation:

  • Auto Sync: Enable this to allow Harmony to update contacts in the background automatically.
  • Sync Direction: Choose Bidirectional (changes in Harmony update Google and vice-versa) or One-way depending on your preference.

Mappings​

  • Object Mappings: Defines which Harmony objects match which Google objects.
  • Field Mappings: Controls specifically which data points correspond to each other (e.g., mapping Harmony's "Job Title" to Google's "Title").

Troubleshooting connections​

Inside the Manage view for any integration, you will find a toolbar of action buttons to resolve issues:

  • Trigger Full Sync: Forces Harmony to re-download all data from the integration immediately. Use this if recent changes aren't showing up.
  • Test Connection: Pings the external service to ensure Harmony can still reach it.
  • Re-authenticate: If you changed your password on the external service, the connection token may expire. Click this to sign in again and refresh the token.
  • Delete: Permanently removes the integration and stops all data syncing.