FamilyChaosFamilyChaos
← Back to docs

External Calendars

Connect Google, Microsoft, Apple, and other calendar services so their events appear alongside your family's own entries.

Adding a calendar connection

Any adult member can pull events from external calendars into the shared FamilyChaos calendar. Open Settings → External Calendars and tap Add Calendar to choose an import method:

  • Google Calendar — connect via Google OAuth. After authorising, choose which of your Google calendars to sync. Events are kept up to date automatically.
  • Microsoft / Outlook Calendar — connect via Microsoft OAuth in the same way as Google.
  • Apple / iCloud Calendar — connect using your Apple ID and an App-Specific Password generated at appleid.apple.com. After connecting, choose which iCloud calendars to sync.
  • Upload .ics file — import a one-time snapshot from any calendar app that can export in iCalendar format.
  • Subscribe to a calendar URL — subscribe to a public WebCal or ICS URL; FamilyChaos fetches and syncs the feed on a schedule.

External events appear on the family calendar alongside events created in FamilyChaos. They are read-only — edit them in the source calendar app.

Managing connections

All active connections are listed on Settings → External Calendars. From there you can:

  • Sync now — tap the sync icon next to a connection to fetch the latest events immediately rather than waiting for the background schedule. Re-syncing updates any events that have changed in the source calendar.
  • Change which calendars are included — for Google, Microsoft, and iCloud connections, tap the edit icon to open the full list of available calendars and toggle individual ones on or off without reconnecting.
  • Assign a colour label — tap the edit icon on any connection to assign a FamilyChaos colour label to it. External events from that connection will appear on the calendar with that label, making it easy to tell them apart from your family's own events.
  • Update subscription URL — for ICS URL connections, tap the edit icon to change the feed URL without removing and re-adding the connection.
  • Remove — disconnects the calendar and deletes all events imported from it. For Google and Microsoft, the OAuth token is also revoked.