← 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.