Calendar Automation

Create or update calendar events from health data.

Important — automation limitations: Your device must be unlocked to read health data, and iOS does not guarantee background runs at your chosen frequency. Review Automation Limitations before relying on automatic exports.

Open the automation

Open Export → Automated on iPhone, or Automations in the iPad sidebar. Select New Automation, or open an existing automation to edit it.

Name, status, and notifications

Enter a name that identifies this automation. Enabled allows automatic runs; leave it off until you are ready.

Choose any run notifications you want:

• Notify on Cache Update reports that export data was prepared.
• Notify When Run reports that calendar events were saved.

Allow notifications when prompted. These notifications report activity; they do not schedule a run.

Set up

1. Choose Calendar as the Automation Type.
2. Select Enable Calendar Access and allow full calendar access when prompted.
3. Choose a writable calendar under Selected Calendar.

Use a dedicated private calendar if you want to keep health events separate. Anyone with access to that calendar may be able to read the exported health data.

To change permission later, open Apple Settings → Privacy & Security → Calendars and select Health Auto Export.

Data Type Settings

Select one Data Type to turn into calendar events: Health Metrics, Workouts, Symptoms, ECG, Heart Rate Notifications, State of Mind, Cycle Tracking, or Medications. State of Mind requires iOS 18 or later; Medications requires iOS 26 or later and separate medication access.

Health metrics

Choose Health Metrics, then open Select Health Metrics and select the measurements you need.

To limit readings to particular apps or devices, open Preferred Sources, choose a metric, and select its sources. All allows every source that has not been excluded. Use Excluded Sources to ignore a source across this automation’s health metrics. Exclusions take precedence; an unselected source is not substituted when a preferred source has no data. Select Save to apply the source choices or Cancel to discard them.

Workouts

Choose Workouts to create an event for each workout. Include Workout Metrics adds readings such as heart rate and active energy to the notes. For Version 2 workout metrics, choose Minutes or Seconds; seconds add more detail. Calendar does not attach GPX route files.

Export Settings

Calendar creates events rather than export files, so there is no JSON, CSV, or Markdown format to choose.

Date Range

Choose Day, Week, Month, or Year for the period of data to process.

Time Grouping

For health metrics, choose Hours, Days, Weeks, Months, or Years. Coarser grouping creates fewer summary events. Days is a useful starting point for a daily overview.

Schedule Reminders

If you want a prompt to unlock and open the app, turn on Enable Reminders. Choose Hourly, Every Day, or Selected Days, then set the minute, time, and days as applicable. Allow notification access when prompted; if access is denied, use Open Notification Settings.

A reminder does not run the automation or confirm a successful sync. Tap it to open the automation, or use Open & Sync on the notification to request a run. The automation must be enabled; a reminder may still appear after a successful background run. Reminder changes apply when you save.

Sync Frequency and save

Choose a number and Minutes, Hours, Days, or Weeks under Sync Frequency—for example, every 15 minutes. This is a desired background cadence, not a guaranteed schedule.

Your device must be unlocked when health data is read. Enable Background App Refresh for Health Auto Export and turn off Low Power Mode for automatic runs. iOS may still delay runs when the device has been inactive or system resources are limited.

Turn on Enabled when you are ready for automatic runs, then select Update to save the automation. You can upload a selected date range immediately using the steps below.

Event contents and updates

Events contain the selected data’s title, dates, and notes.

Running the automation again updates matching events or creates new ones. Events are not deleted automatically. Manual edits to generated events may be overwritten by a later run.

If you change the selected calendar, new events go to the new calendar; existing events in the previous calendar remain there.

Workout events

Workout notes can include selected workout metrics and available effort scores. Whole-workout and individual-activity scores are shown separately; an activity score does not replace a missing whole-workout score.

Export historical or missed data

Use Manual Upload when you first set up the automation to export historical data, or later to cover dates missed by automatic syncing. You can also use it to check your setup.

1. Open the automation and select Manual Upload under Export Existing Data.
2. Set the Start and End dates, then select Begin Export.
3. Open Calendar, make the selected calendar visible, and inspect the events and notes.

Troubleshooting

• No events: Confirm full calendar access, a writable selected calendar, and the requested date range. Check Activity Logs.
• Too many events: Choose fewer metrics or coarser time grouping.
• Events missing on another device: Check the calendar account’s synchronization and network connection.

Open the automation and select View Activity Logs to check failed steps. For support, see Getting Help.