Sync Your Heima Calendars & Contacts on Any Device

Heima lets you sync your household calendars and contacts to your phone, tablet, or computer using standard CalDAV and CardDAV protocols. Once set up, your Heima events and contacts appear in your favorite calendar and contacts apps — Apple Calendar, Google Calendar, DAVx5, Outlook, or any app that supports CalDAV/CardDAV.

What Are CalDAV and CardDAV?

CalDAV and CardDAV are open standards for syncing calendars and contacts between apps and services. Instead of being locked into a single app, these protocols let you access your Heima calendars and contacts from virtually any calendar or contacts app on any device.

CalDAV syncs calendars and events.
CardDAV syncs contacts.

You don't need to understand the technical details — the setup wizard walks you through everything step by step.

Getting Started

Opening the Setup Wizard

Go to Settings → Calendar & Contacts Sync.
Tap Setup Wizard.

The wizard guides you through four steps: choosing your platform, creating an app password, setting access scope, and connecting your device.

Setup Wizard

Step 1: Choose Your Platform

Select the type of device you want to sync with:

Platform	Best for
iOS	iPhone, iPad, or Mac. Supports automatic profile installation or manual setup.
Android	Android phones and tablets. Uses the free DAVx5 app.
Manual	Any other device or app that supports CalDAV/CardDAV.

You can change the platform at any time during setup.

Step 2: Create an App Password

Heima uses dedicated app passwords for calendar and contacts sync. This keeps your main account password separate and secure.

Enter a label for the password — something that helps you identify the device later, e.g. "iPhone" or "Work laptop".
Tap Create.
Your app password is displayed. Copy it now — it cannot be shown again after you leave this step.

Important: Each app password is shown only once. If you lose it, you'll need to revoke it and create a new one.

Step 3: Set Access Scope

Choose which Spaces this connection can access. This controls which calendars and contacts are visible to the connected device.

Scope	Description
All spaces	Full access to calendars and contacts from every Space you belong to.
One space	Restrict access to a single Space.
Selected spaces	Pick specific Spaces to include.

This is useful if you have multiple Spaces (e.g. family and work) and only want certain calendars on certain devices.

Step 4: Connect Your Device

The wizard displays your connection credentials:

Username
CalDAV URL
CardDAV URL
App password

Use the Copy All button to copy everything at once. Then follow the platform-specific instructions below.

Platform Setup Instructions

iOS (iPhone, iPad, Mac)

You have two options:

Option A: Automatic profile (recommended)

In the wizard's Connect step, tap Generate .mobileconfig.
A configuration profile is created and ready to install.
Open it on your device and follow the prompts to install.
Your CalDAV and CardDAV accounts are added automatically.

Note: iOS may warn that this is an unsigned profile. This is expected and safe to accept.

Option B: Manual setup

On your device, go to Settings → Calendar → Accounts → Add Account → Other.
Tap Add CalDAV Account.
Enter the server URL, username, and app password from the wizard.
Repeat for Add CardDAV Account using the CardDAV URL.

Android

Install DAVx5 from the Play Store (it's free and open source).
Open DAVx5 and tap Add account.
Paste the CalDAV or CardDAV URL from the wizard.
Enter your username and app password.
DAVx5 will discover your calendars and contacts automatically.

Manual Setup

For other apps or devices, use the CalDAV and CardDAV URLs along with your username and app password. Consult your app's documentation for where to enter CalDAV/CardDAV account details.

Account Scope Settings

After completing the wizard, you can adjust your sync settings at any time from Settings → Calendar & Contacts Sync.

Include Toggles

Include calendars — when enabled, your Heima calendars and events are available over CalDAV. Turn this off if you only want to sync contacts.
Include meal planner — when enabled, your meal planner appears as a read-only calendar over CalDAV. Planned meals show up in your calendar app alongside your other events.

Note: Account scope applies to both CalDAV and CardDAV visibility. The include toggles only affect calendar feeds.

Space Scope

You can change which Spaces are included in the sync at any time:

Go to Settings → Calendar & Contacts Sync.
Under Account Scope, choose your scope mode (all, one, or selected spaces).
If using one or selected, pick the Spaces you want.
Save your changes.

Managing App Passwords

Each device or app you connect uses its own app password. You can manage all of them from the sync settings page.

Viewing App Passwords

Under Per App Password Scope, you'll see a list of all your app passwords with:

The label you gave it.
When it was created.
When it was last used.

Per-Password Scope

Each app password can have a stricter scope than your account defaults. For example, your account might have access to all Spaces, but you can limit a specific app password to only one Space.

Tap an app password from the list.
Adjust the scope mode and selected Spaces.
Save your changes.

This is useful when you want different devices to see different sets of calendars and contacts.

Revoking an App Password

If a device is lost, replaced, or you no longer need the connection:

Tap the app password you want to remove.
Tap Revoke.
Confirm the action.

The app password stops working immediately. Any device using it will no longer be able to sync calendars or contacts.

Calendars

Heima calendars are shared within a Space. When calendar sync is enabled, all calendars you have access to appear in your connected calendar app.

Calendar Sharing Roles

Calendars in Heima support different permission levels for members:

Role	What you can do
Editor	View and modify events — add, edit, and delete.
Reader	View all event details, but cannot make changes.
Free/Busy	Can only see whether time slots are free or busy — no event details.

These roles control what each member sees both in Heima and through CalDAV sync.

Contacts

Contacts in Heima are organized by Space. When contacts sync is enabled, your Space contacts appear in your device's contacts app via CardDAV.

Contact details in Heima include:

Identity — name and other identifying information.
Communication — phone numbers and email addresses.
Address — physical addresses.
Organization — company or group affiliations.

Changes made in your contacts app sync back to Heima, and changes in Heima sync to your connected devices.

Meal Planner Calendar Subscription

The meal planner in Heima can be accessed as a calendar subscription, separate from the full CalDAV sync.

From the Meal Planner screen, tap Subscribe to calendar to get a subscription URL. Add this URL to any calendar app that supports calendar subscriptions (iCal format). Your planned meals will appear as events in your calendar and update automatically when you make changes in the meal planner.

Tip: This is a read-only subscription — you can view your meal plan in your calendar app, but changes must be made in Heima.

Tips for Getting the Most Out of Calendar & Contacts Sync

Use descriptive labels for app passwords so you can identify which device each one belongs to — e.g. "Sarah's iPhone" or "Kitchen tablet".
Limit scope per device if you don't need all Spaces everywhere. A work phone might only need your work Space.
Enable the meal planner calendar to see your weekly meal plan alongside your other events without any extra apps.
Revoke unused passwords promptly when you replace a device or no longer need a connection.
Use the iOS .mobileconfig profile for the quickest setup on Apple devices — it configures both CalDAV and CardDAV in one step.
On Android, use DAVx5 — it's the most reliable free app for CalDAV/CardDAV sync and discovers all your calendars and contacts automatically.

Calendar & Contacts Sync