Sync Apple Health Data to Calendar

Calendar automations allow you to automatically create calendar events in your iOS Calendar app based on your health data. This is ideal for visualizing health metrics, workouts, and other health events directly in your calendar.

Overview

Calendar automations create calendar events in your selected calendar app for various health data types. Events can represent workouts, health milestones, symptoms, or other health-related activities, making it easy to see your health data alongside your schedule.

Use Cases:

• Visualizing workouts in your calendar
• Tracking health milestones and events
• Viewing health data alongside your schedule
• Creating reminders for health-related activities
• Sharing health events with others through calendar sharing

Key Features:

• Creates calendar events for health data
• Updates existing events when data changes
• Supports all health data types
• Works with any calendar app that supports iOS Calendar
• No file format selection (creates events, not files)

Limitations:

• Health Data Access: Apps are not allowed to access health data while iPhone is locked. Automations will only run during periods when your device is unlocked. This can affect data freshness. See instructions for manual syncing to keep data up to date.

• Background Processing: iOS limits background processing to preserve battery life. Automations rely on Background App Refresh and may not run immediately if:

  • Background App Refresh is disabled for the app
  • The device is in Low Power Mode
  • The device has been inactive for extended periods
  • System resources are constrained
  • Multiple apps are competing for background execution time

Prerequisites

• iOS Calendar app access
• At least one calendar configured in the Calendar app
• Calendar access permission granted to the app

Configuration

Navigate to the Automated Exports screen from the main navigation, then tap New Automation" and select "Calendar" as the Automation Type.

Automation Name

Enter a descriptive name for your automation (e.g., "Workout Calendar", "Health Events", "Daily Health Summary").

Notifications

Configure when you want to receive notifications:

• Status Enabled - Toggle to enable or disable the automation
• Notify on Cache Update - Receive a notification when cached data is updated
• Notify When Run - Receive a notification each time the automation creates/updates events

Note: Calendar events themselves may trigger calendar notifications depending on your Calendar app settings.

Calendar Access

Before configuring other settings, you must grant the app access to your calendars.

Enabling Calendar Access

1. When you first configure a Calendar automation, you'll see an "Enable Calendar Access" button
2. Tap "Enable Calendar Access"
3. You'll be prompted to grant calendar access
4. Tap "Allow" to grant access to your calendars

Note: The app only needs access to create and update calendar events. It does not read existing events unless they were created by the automation.

Managing Calendar Access

If you need to change calendar access:

1. Go to Settings > Privacy & Security > Calendars
2. Find the app in the list
3. Toggle access ON or OFF as needed

Calendar Selection

Select which calendar to use for health events:

1. Tap the "Selected Calendar" picker
2. Choose from your available calendars
3. The selected calendar will be used for all events created by this automation

Calendar Options:

• Any calendar you have configured in the Calendar app
• iCloud calendars
• Google calendars (if synced)
• Other calendar accounts (Exchange, etc.)

Tip: Create a dedicated calendar for health data to keep it organized and easily toggleable in the Calendar app.

Data Type Settings

Data Type

Select which type of health data to create calendar events for:

• Health Metrics - Creates events for health measurements
• Workouts - Creates events for exercise activities
• Symptoms - Creates events for health symptoms
• ECG - Creates events for ECG readings
• Heart Rate Notifications - Creates events for heart rate alerts
• State of Mind - Creates events for mood entries (iOS 18.0+)
• Cycle Tracking - Creates events for menstrual cycle data
• Medications - Creates events for medication logs (iOS 26.0+)

Health Metrics Configuration

When Health Metrics is selected:

Select Health Metrics - Choose which specific metrics to include in calendar events. You can select all available metrics or choose specific ones.

Tip: Selecting fewer metrics creates cleaner calendar events with less information.

Preferred Sources - Configure which data sources take priority when multiple sources provide the same metric.

Workout Configuration

When Workouts is selected:

Include Route Data - Toggle ON or OFF. Route data is not included in calendar events but may be referenced.

Include Workout Metrics - Toggle ON to include health metrics in workout events (heart rate, calories, etc.).

Time Grouping (Workout Metrics) - When using Export Version 2 and Include Workout Metrics is enabled:

• Minutes - Groups workout metrics by minute
• Seconds - Groups workout metrics by second

Note: Workouts are ideal for Calendar automations as they naturally represent time-bound events.

Export Settings

Date Range

Select how data should be organized:

• Day - Creates events for daily data
• Week - Creates events for weekly data
• Month - Creates events for monthly data
• Year - Creates events for yearly data

Event Organization:

• Events are created based on the date range selected
• Each event represents data for that time period
• Events are updated when the automation runs again

Time Grouping

Select how data should be aggregated for calendar events. Available options:

• Hours - Creates events grouped by hour
• Days - Creates events grouped by day
• Weeks - Creates events grouped by week
• Months - Creates events grouped by month
• Years - Creates events grouped by year

Note: More granular grouping (hours) creates more events. Less granular grouping (weeks/months) creates fewer summary events.

Tip: Use "Days" for most use cases to balance detail with calendar clutter.

Sync Cadence

Configure how often the automation should create/update calendar events.

Select a number and interval.

Event Details

Event Information

Calendar events created by the automation include:

• Title - Based on the data type and content (e.g., "Running Workout", "Health Metrics Summary")
• Start Date - Beginning of the time period
• End Date - End of the time period
• Notes - Detailed health data in text format
• Calendar - Your selected calendar

Event Updates

• Events are updated when the automation runs again
• Existing events are found and updated based on the event key
• New events are created if no matching event exists
• Events are not deleted automatically

Troubleshooting

Viewing Activity Logs

1. Tap "View Activity Logs" in the automation configuration screen
2. Review recent automation runs
3. Check for event creation errors
4. Verify event creation timestamps

Common Issues

Calendar Access Not Granted

• Tap "Enable Calendar Access" if shown
• Go to Settings > Privacy & Security > Calendars
• Ensure the app has calendar access enabled
• Re-grant access if needed

Events Not Appearing

• Verify calendar access is granted
• Check that a calendar is selected
• Ensure the automation is enabled
• Check the date range - events are created for the selected period
• Verify the selected calendar is visible in Calendar app
• Check Activity Logs for creation errors

Events Not Updating

• Events are updated when the automation runs
• Ensure sync cadence is appropriate
• Check that the automation is running successfully
• Verify events exist for the time period

Wrong Calendar Selected

• Tap "Selected Calendar" to change the calendar
• Select the desired calendar from the list
• New events will be created in the newly selected calendar
• Old events remain in the previous calendar

Too Many Events

• Reduce the number of selected health metrics
• Use less granular time grouping (Days instead of Hours)
• Consider using a longer date range (Week/Month instead of Day)
• Create separate automations for different data types

Calendar Not Syncing

• Ensure your calendar account is properly configured
• Check calendar sync settings in Settings > Calendar
• Verify internet connectivity for cloud calendars
• Wait for calendar sync to complete

Error Messages

The app will display error messages if:

• Calendar access is not granted
• No calendar is selected
• Calendar creation fails
• Calendar account is unavailable

Check the Activity Logs for detailed error information.

Tips and Best Practices

1. Calendar Selection:

   • Create a dedicated "Health" calendar for better organization
   • Use a calendar you can easily toggle on/off
   • Consider sharing the calendar with family members if desired

2. Event Organization:

   • Use descriptive automation names
   • Consider creating separate automations for different data types
   • Use different calendars for different health data types

3. Time Grouping:

   • Use "Days" for most use cases
   • Use "Hours" only if you need detailed hourly tracking
   • Use "Weeks" or "Months" for summary events

4. Data Selection:

   • Select only the metrics you want in calendar events
   • Too many metrics can make events cluttered
   • Consider separate automations for different metric groups

5. Sync Frequency:

   • More frequent syncs update events more often
   • Consider notification settings when choosing frequency

6. Workout Events:

   • Workouts work particularly well as calendar events
   • Include workout metrics for detailed event information
   • Events show workout duration, type, and key metrics

7. Calendar Sharing:

   • Share your health calendar with family or healthcare providers
   • Use iCloud calendar sharing for easy access
   • Consider privacy when sharing health data

8. Event Management:

   • Events can be edited manually in the Calendar app
   • Manual edits may be overwritten when automation runs
   • Consider using read-only calendar sharing if needed

9. Privacy:

   • Health data in calendar events is visible to anyone with calendar access
   • Consider privacy when sharing calendars
   • Use a private calendar for sensitive health data

10. Integration:

    • Calendar events work with all calendar apps
    • Events sync across devices via iCloud/Google/etc.
    • Use calendar widgets to view health events
    • Integrate with other calendar-based apps

11. Performance:

    • Creating many events may take time
    • More frequent syncs create more calendar activity
    • Balance between detail and calendar clutter

12. Visualization:

    • Use calendar views to see health patterns over time
    • Color-code events using calendar colors
    • Use calendar search to find specific health events
    • Export calendar to share health timeline