User Guide
Wish Genie reads data from the Health app (more than 70 kinds, plus workouts) and sends it where you choose: iCloud Drive, Dropbox, Google Drive, OneDrive (personal accounts), your own REST API, or a file you share yourself. It can also turn your data into hourly or daily values, or a summary that an AI assistant app can read, and you can ask an AI model about that summary in the app with your own OpenRouter account. It has no account and no server of its own. Get it on the App Store.
1. Allow Health access
The first time you open the app, tap "Allow Health access". iOS lists each kind of Health data so you can choose what Genie reads. If you skipped this, tap "Allow Health access" on the home screen or in Settings › Health data. If a task fails because Genie can't read Health data, the task shows "Check Health access", which leads to the same steps.
iOS shows that list only once. To change it later, open the iPhone Settings app › Privacy & Security › Health › Wish Genie. Genie only reads Health data; it never writes to it.
Updated from an earlier version? Versions 1.4 and 1.7 can read new kinds of data, so the home screen shows "More Health data can be read". Tap the button and iOS lists only the kinds you haven't answered yet; turn on the ones you want.
Workout Routes, Cycle Tracking and State of Mind aren't in that first list. iOS asks about them the first time you choose them in a task or an export, so you're only asked if you use them.
On iOS 27, after you allow access, iOS also asks "How much data do you want to share with Wish Genie?": the past 30 days and future data, or all recorded data and future data. If you choose the past 30 days, Wish Genie can't read anything from before the 30 days ending on the day you allowed it. That start day stays fixed; it doesn't move forward. An AI summary then marks earlier days as "not shared" (see section 6), and manual export shows a note under the dates. To share everything, open the iPhone Settings app › Health › Data Access & Devices › Wish Genie and set each item to Full Access. There's no button to change them all at once. (These are the names Wish Genie uses; your iOS version may word them slightly differently.)
2. Add a destination
A destination is a place your tasks send data to. Open "Manage destinations" on the home screen (or Settings › Destinations) and tap "Add a destination".
- iCloud Drive: no sign-in needed. Genie saves files in the Wish Genie folder of your own iCloud Drive, so you can open them in the Files app (iCloud Drive › Wish Genie). iCloud Drive must be on: iPhone Settings › your name › iCloud.
- Dropbox, Google Drive, OneDrive: tap "Connect account" and sign in. Genie saves files in its own folder: Apps › Wish Genie in Dropbox and OneDrive, and a "Wish Genie" folder in Google Drive. It can't see your other files. OneDrive works with personal Microsoft accounts only, not work or school accounts.
- REST API: enter the URL. Add headers such as an API key under "Headers". If the URL itself contains a token, turn on "URL contains a secret" and the full URL is kept in the iPhone Keychain. Plain http:// is allowed only for addresses on your own network (see Support).
To disconnect a cloud account, open the destination and tap "Disconnect". You can also remove Wish Genie's access from the service's own account settings.
3. Give Genie a task
Tap "Give Genie a task". Since 1.9, Genie walks you through it one question at a time: what it's for (A summary for AI, Back up raw data, Send to my server, or I'll set it up myself), which data (Everyday basics, Activity, All data, or Pick my own), where to send it (you can add a destination right there), and how often. Each answer fills in sensible defaults, and the last step shows the finished task. Tap "Back" to change an earlier answer, or "Show all settings" on the first step to see everything on one screen. Editing an existing task opens the full editor.
A task is one sentence, for example "Send every reading of Heart Rate as JSON to Home NAS every hour." Tap any highlighted word to change the data, what goes in the file (every reading, hourly or daily values, or an AI summary; see section 6), the format (JSON or CSV; Markdown or JSON for an AI summary), the destination or how often it runs (every 15 or 30 minutes, every hour, every 6 or 12 hours, every day or every week; an AI summary runs every day or every week). A daily task sends at the time you pick under "Send at"; a weekly task also lets you pick the day of the week. New tasks start at 8:00 (Monday for weekly), and you can change this later. On the data page, "Select all" picks every kind of data at once, except Cycle Tracking and State of Mind: tap those yourself if you want them ("Deselect all" clears them). For hourly or daily values or an AI summary, the Cycle Tracking group isn't shown (see section 5). Then tap "Hand it to Genie".
Genie won't send anything until you give it a task. Each run sends only data that is new since the last successful run.
- Export now: open the task and tap "Export now" to send new data right away.
- Pause: turn the task's switch off. "Export now" still works.
- Remind me if it doesn't send: turn this on in a task, and if the task is an hour late (for example because your iPhone stayed locked), Genie sends you a notification. Open Wish Genie and it catches up. iOS asks for permission to send notifications the first time you turn it on.
- Resend recent data: for a task with every reading or hourly or daily values that has sent before, sends the last day, 7 days or 30 days again. Use it when the receiving end missed something. Data that was already sent goes again: skip records you already have (every reading has a uuid), or replace hourly and daily values that have the same data type and start time.
- Run now: shown on the home screen when a task failed, to try again immediately.
- Also save a latest copy: for a task with hourly or daily values or an AI summary that sends to iCloud Drive, Dropbox, Google Drive or OneDrive. Each time it sends, Genie also saves the same file under a fixed name, WishGenie-<task name>-latest.md (or .json or .csv), replacing the copy from the run before, so an AI assistant app or another tool can always read one file on a schedule (see section 8). The actual file name is shown below the switch. Characters that can't be in a file name become -, the name is cut to 40 characters, and two tasks with the same name get a short ID added. If you rename the task, the next copy uses the new name; the old file stays, because Genie doesn't delete files in your cloud. It isn't offered for tasks with every reading (each run sends only the new data, not the whole period) or for a REST API. If the latest copy couldn't be saved, the main file was still sent and the task shows a red message (see Support).
4. When automatic exports run
Automatic exports run in the background when iOS gives the app time, so the exact timing is decided by the system and can be later than the schedule. A late run doesn't move the schedule: a daily task set for 12:30 keeps running around 12:30, and if several runs were missed, Genie catches up once. Health data can't be read while your iPhone is locked, so a run that falls in that window waits. If you change the time of a daily or weekly task, the next run is the next time it's due after you save; times that already passed aren't sent. To catch up right away, open Wish Genie (it sends every task that is due), tap "Catch up" on the widget, or turn on "Remind me if it doesn't send" on the task. If a task shows an error, see what the messages mean.
5. What gets exported
More than 60 kinds of Health data, grouped the same way as in the app:
- Activity: Steps, Walking + Running Distance, Flights Climbed, Active Energy, Resting Energy, Exercise Minutes, Stand Minutes, Move Minutes, Physical Effort, Swimming Distance, Swimming Strokes, Wheelchair Distance, Wheelchair Pushes, Time in Daylight, Stand Hours, Activity Rings
- Running: Running Speed, Running Power, Running Stride Length, Vertical Oscillation, Ground Contact Time
- Walking: Walking Speed, Walking Step Length, Walking Asymmetry, Double Support Time, Stair Speed: Up, Stair Speed: Down, Six-Minute Walk
- Cycling: Cycling Distance, Cycling Speed, Cycling Power, Cycling Cadence, Cycling Functional Threshold Power
- Heart: Heart Rate, Resting Heart Rate, Heart Rate Variability, VO₂ Max, Walking Heart Rate Average, Cardio Recovery, Systolic Blood Pressure, Diastolic Blood Pressure
- Body: Blood Oxygen, Respiratory Rate, Weight, Body Temperature, Height, Body Fat Percentage, Lean Body Mass, Body Mass Index, Waist Circumference, Blood Glucose
- Nutrition: Dietary Energy, Protein, Carbohydrates, Total Fat, Dietary Sugar, Fiber, Sodium, Caffeine, Water
- Hearing: Environmental Sound Levels, Headphone Audio Levels
- Sleep
- Mental Wellbeing: Mindful Minutes, State of Mind
- Cycle Tracking: Menstruation, Spotting, Ovulation Test Result, Cervical Mucus Quality, Infrequent Periods, Irregular Cycles, Persistent Spotting, Prolonged Periods
- Workouts
Workout Routes (in the Workouts group) are the GPS tracks recorded during outdoor workouts, for example by your Apple Watch. They contain locations. Routes need a task or a manual export of their own: choosing Workout Routes clears the other kinds, choosing another kind clears Workout Routes, and the file contents must be every reading. The format is always GPX:
- One .gpx file per workout, named like WishGenie-route-20261118T073000Z-walking-1a2b3c4d.gpx (start time in UTC, activity, short ID). A task sends each file separately, so a REST API receives one request per workout.
- Each route recorded during the workout is one track segment. Each point has latitude, longitude, elevation and time, plus the heart rate when one was recorded within 30 seconds of that point (as hr in Garmin's TrackPointExtension).
- Workouts without a route, such as indoor workouts, don't produce a file. If none of the workouts in the period has a route, manual export says "There are no workout routes in this date range."
- You can import the files into Strava, Garmin Connect and other fitness apps that accept GPX.
- Routes are never put in hourly or daily values, AI summaries, Ask AI, the home screen, widgets or a latest copy.
- JSON or CSV. Every sample has a unique ID, so your server or script can safely ignore duplicates.
- Fields: each sample has type, start, end, value, unit, source and uuid. Sleep is one row per segment, with the minutes as its value and a stage: deep, rem, core, awake, inBed, or unspecified (asleep, but no stage was recorded).
- Workouts: one row per workout, with its length in minutes as the value. It also has the activity (for example running) and, when they were recorded, the distance in meters, active energy in kcal, average and maximum heart rate, and whether it was indoors. In JSON these are in a "workout" object; a CSV file has six workout_ columns, which are empty for other kinds of data.
- Stand Hours: one row per hour, with 1 as the value if you stood during that hour or 0 if you didn't (category stood or idle). Mindful Minutes: one row per session, with its length in minutes as the value.
- State of Mind: one row per entry, with the valence as the value, from −1 (very unpleasant) to +1 (very pleasant). It also has the kind (momentaryEmotion for an emotion, dailyMood for the whole day), the classification (for example slightlyPleasant), and the labels (for example calm or stressed) and associations (for example work or family) that were chosen. In JSON these are in a "stateOfMind" object.
- Activity Rings: one row per day, with the number of rings closed (0 to 3) as the value. It also has each ring's value and goal (Move in kcal, Exercise in minutes, Stand in hours) and whether the rings were paused that day. In JSON these are in a "rings" object.
- Cycle Tracking: one row per entry, with its length in minutes as the value. Menstruation has the flow (unspecified, light, medium, heavy or none) and, when it was recorded, whether the entry marks the start of a cycle. An ovulation test result is negative, luteinizingHormoneSurge, estrogenSurge or indeterminate; cervical mucus quality is dry, sticky, creamy, watery or eggWhite. In JSON these are in a "category" object (value and cycleStart).
- CSV columns: after the six workout_ columns, a CSV file ends with 14 more columns, empty for other kinds of data: category, cycle_start, mood_kind, mood_valence, mood_classification, mood_labels, mood_associations (labels and associations are separated by ;), rings_move_kcal, rings_move_goal_kcal, rings_exercise_min, rings_exercise_goal_min, rings_stand_h, rings_stand_goal_h and rings_paused, 28 columns in all. They're added after the earlier columns, which haven't changed, so a program that reads columns by name keeps working.
- Good to know: Activity Rings are read only when a task runs or you export manually; iOS doesn't wake the app for them. If your Move ring uses Move time (minutes) as its goal, "rings closed" doesn't count the Move ring, because only calories are compared. Stand Hours can be counted more than once when more than one device recorded the same hour. A mindful session that goes past midnight counts on the day it started.
- Units are fixed for each kind of data, for example mmHg for blood pressure, mg/dL for blood glucose and cm for height. Percentages are from 0 to 100.
- File names look like WishGenie-<task>-<time in UTC>.json. A REST API receives the same content as the request body.
6. Hourly and daily values, and AI summaries
Instead of every reading, a manual export or a task can put one of these in the file (choose it under "What goes in the file?"):
- Hourly or Daily: one value per data type for each hour or each day. Data that adds up, such as steps, distances, energy, exercise minutes, time in daylight and nutrition, is a total. Workouts are the total minutes and the number of workouts (JSON also lists them per activity). Sleep is the total minutes asleep (the "asleep" column: REM, core, deep and unspecified together) plus minutes per stage (in bed, awake, REM, core, deep, unspecified); in daily values, a night counts on the day you woke up. Everything else has the average, lowest and highest value and how many readings there were. Stand Hours and Mindful Minutes are totals, and State of Mind is the average, lowest and highest valence. Activity Rings are in daily values only, with the rings closed and each ring's value and goal (a CSV file ends with seven rings_ columns, 23 columns in all). JSON or CSV, with no device names or sample IDs.
- AI summary: the last 7, 30 or 90 complete days (today isn't included), compared with the same number of days before that. For each data type: the daily average, the change in %, the lowest and highest day and how many days had data, plus a table of daily values for the kinds that had data, the average sleep stages, and the number and total time of workouts per activity. Markdown (easy for AI assistant apps and people to read) or JSON. The file is written in English and is not a medical record. In JSON (schemaVersion 2), each day of a kind that is averaged, such as heart rate, also has that day's lowest and highest value (min and max). Stand Hours and Mindful Minutes are daily totals; State of Mind is the daily average valence (−1 very unpleasant to +1 very pleasant) and the number of entries; Activity Rings are the rings closed per day and, for each ring, the days it was closed and how much of the goal was reached on average.
Cycle Tracking is never put in hourly or daily values or an AI summary, and it's never sent with Ask AI. It's only in exports with every reading (JSON or CSV), which go only to the destination you chose.
An AI summary file only goes where you send it; Wish Genie doesn't send it to any AI service. (To ask an AI model inside the app instead, see Ask AI.) To ask an AI assistant app about your data, share the file to that app from manual export, or upload it from the folder your task sends it to. If you share it with an AI app, that company receives this health data.
A Markdown AI summary starts with this note for your AI assistant. To leave it out, turn off "Add a note for AI assistants" in the task or in manual export.
## For your AI assistant Wish Genie added this note so an AI assistant can read the data below. Please: 1. Summarize the main trends over this period and compare them with the previous period (see "Change"). 2. Point out days or values that stand out from this person's usual range. 3. Treat days without data as missing. Do not guess values. 4. Use plain language and keep it short. Do not diagnose or suggest treatment. If something looks concerning, suggest talking to a doctor. This note only asks for an analysis of the data in this file.
- Tasks with hourly or daily values send an hour or a day only after it has ended. Watches often sync late, so each run also sends the last 24 hours (hourly) or the last 7 days (daily) again with up-to-date numbers. If your server or script keeps them, replace earlier values that have the same data type and start time instead of adding them again.
- AI summary tasks run every day or every week, and every run sends a whole summary. If there's no data for the period, nothing is sent.
7. Ask AI
Ask an AI model questions about a summary of your Health data, right in the app. It uses your own OpenRouter account (a service that connects to AI models from many companies), and you pay OpenRouter for what you use. Ask AI needs Basic or Premium.
- Start: tap "Ask AI about your Health data" on the home screen (or Settings › AI assistant › Open AI assistant).
- Agree first: the first time, "Before you ask AI" explains what's sent, who receives it, that it uses your own account, and that answers aren't medical advice. Nothing is sent until you tap "I agree". You can withdraw this in Settings › AI assistant › Withdraw agreement.
- Connect OpenRouter: tap "Connect OpenRouter", sign in (or create an account) and allow access. You come back to Wish Genie, sometimes through a short page on this website. To add credits, open openrouter.ai and go to Settings › Credits.
- New conversation: pick the days (7, 30 or 90) and which data to include, and choose a model. Genie makes the same summary as the AI summary export, then you type a question and tap "Send". Answers can take up to a minute; you can cancel while waiting. Answers are in the app's language. Cycle Tracking isn't in the list of data, so it's never sent.
- What's sent: each question sends the summary, the earlier questions and answers in that conversation and your new question, from your iPhone to OpenRouter, which passes them to the company behind the model you chose.
- Choosing a model: three recommended models are at the top with their prices (US dollars per million tokens, charged by OpenRouter). "Other models" lists the rest and can be searched. Free models are often busy, and the companies behind some models may keep what you send and use it to train their models. In your OpenRouter account's privacy settings (Settings › Privacy) you can turn off providers that may train on your data, separately for paid and free models; some models may then be unavailable.
- Not medical advice: AI answers can be wrong. Every answer carries a reminder to talk to a doctor about anything concerning.
- Conversations are saved only on this iPhone, not in iCloud or your backups. Delete one with the trash button, or all of them in Settings › AI assistant › Delete all conversations.
- Save as a report: makes a Markdown file of the questions and answers (without your Health summary) that you can share or save.
- Disconnect: Settings › AI assistant › Disconnect removes the key from this iPhone. To delete the key from your OpenRouter account too, open "Open the OpenRouter Keys page" and delete the key named "Wish Genie".
If something goes wrong, see what the Ask AI messages mean.
8. Let an AI read your exports on a schedule
If you use your own AI tools, such as an AI assistant app or an AI agent that can read files in your cloud on a schedule, it can read a fresh summary every day without you sharing a file by hand. Wish Genie only puts the file in your cloud; your AI tool reads it from there.
- Add a cloud destination: iCloud Drive, Dropbox, Google Drive or OneDrive (see section 2).
- Give Genie a task: choose "A summary for AI" (or, in the full editor, an AI summary; Markdown is easiest for an AI to read), the last 7, 30 or 90 days, every day at the time you pick under "Send at", to that destination.
- In the task, turn on "Also save a latest copy" and note the file name shown below the switch, for example WishGenie-Health summary-latest.md. It's in Genie's folder of that destination (iCloud Drive › Wish Genie, Apps › Wish Genie in Dropbox and OneDrive, or the "Wish Genie" folder in Google Drive).
- In your AI tool, give it access to that file or folder and set it to read that file on a schedule. Leave some time after the task's send time (for example an hour or more), because iOS decides exactly when background exports run. The summary shows the period it covers, so the AI can tell how recent it is.
- Wish Genie never sends your data to an AI service by itself. The only time it does is when you use Ask AI. When your AI tool reads the file from your cloud, the company behind that tool receives this health data, and its own terms apply.
- Cycle Tracking is never in an AI summary. A Markdown summary starts with the note for your AI assistant (see section 6), which asks it not to diagnose; you can turn the note off.
- Health data can't be read while your iPhone is locked. Turn on "Remind me if it doesn't send" in the task, or open Wish Genie, so the day's file isn't missed.
- For your own program instead of an AI, a task with hourly or daily values (JSON or CSV) can keep a latest copy too.
Tasks need Premium (automatic exports).
9. Manual export
Tap the share button on the home screen ("Export once"), choose "What goes in the file?" (raw data, hourly, daily or an AI summary), "Which data?" and "Which days?" (an AI summary uses the last 7, 30 or 90 complete days instead), pick a file format, then tap "Create file and share" to save the file to Files, AirDrop it or send it anywhere. Manual export needs Basic or Premium.
- Workout Routes: choose raw data, then Workout Routes in the Workouts group. The format becomes GPX, and all the GPX files (one per workout) are shared at once.
- Only recent data shared: if the dates start before the day Apple Health shares a chosen kind from, a note under the dates lists those kinds and how to share everything (see section 1). You can still export; earlier days just won't be in the file.
10. Shortcuts and Siri
In the Shortcuts app, Wish Genie adds three actions: "Export Health Data" (returns a JSON or CSV file of raw readings for today, yesterday, or the last 7 or 30 days, for any of the kinds of data above except Workout Routes), "Export Workout Routes" (since 2.0: returns one GPX file per workout with a route, for today, yesterday, or the last 7 or 30 days) and "Run Task" (sends a task's new data now). You can also ask Siri. Shortcuts need Basic or Premium.
Tip: to send at a set time, create a personal automation in the Shortcuts app (Time of Day) that runs "Run Task". It still can't read Health data while your iPhone is locked.
11. Home screen and widgets
The home screen shows three tiles, one large and two small (heart rate, steps and sleep to start). To change them, open Settings › Tiles, tap a tile and pick what it shows. Blood pressure, height, nutrition, workouts, Stand Hours, Activity Rings, Mental Wellbeing and Cycle Tracking can't be shown on a tile. Your Home Screen widgets (small, medium and large) show the same three; the large widget also shows today's trend for the first tile. Readings you take only now and then, such as weight or VO₂ Max, show the most recent value from the last 30 days with its date. Widget values are hidden while your iPhone is locked. When you have a task that's turned on, the widget also shows a "Catch up" button: it opens Wish Genie, sends the tasks that are due and shows the result.
12. Plans
- Free: Home Screen widgets and charts.
- 7-day free trial: tap "Start 7-day free trial" on the plans screen. It starts only when you tap it and never turns into a paid subscription.
- Basic (one-time purchase): manual export, including hourly, daily and AI summary files and workout routes (GPX), Shortcuts, and Ask AI (with your own OpenRouter account).
- Premium (lifetime purchase or yearly subscription): automatic exports (any file contents, including AI summaries and workout routes) to iCloud Drive, Dropbox, Google Drive, OneDrive or your REST API, plus everything in Basic.
Prices are shown on the plans screen and on the App Store page, in your own currency. Bought on another device or reinstalled? Tap Settings › "Restore Purchases".
13. Privacy
We don't collect any data. Your health data goes straight from your iPhone to the destinations you set up. Cloud sign-ins, secret headers and secret URLs are stored in the iPhone Keychain on this device only. Your data goes to an AI service only when you use Ask AI: then the summary and your questions go from your iPhone to OpenRouter and the company behind the model you chose. An AI summary file goes only where you share or send it, and Cycle Tracking is never put in an AI summary or sent with Ask AI. Workout routes contain locations: Wish Genie reads them from Health only if you choose Workout Routes, doesn't use Location Services, and sends them only where you export them; they're never in an AI summary or Ask AI. Details are in the Privacy Policy.