---
title: "Phone tools"
description: "How the assistant uses each person’s iPhone (Reminders, Calendar, Apple Weather, Location and, if turned on, Apple Health), always after they tap Allow."
url: https://www.hervi.app/docs/phone-tools/
---

# Phone tools

With the Hervi plugin, the assistant can use the apps on each person's own iPhone. Every request shows a card in the
chat, reads included, and **nothing happens until the person taps Allow**. If they tap Not now, or don't answer
within five minutes, nothing is done and the assistant is told so.

## What it can do

| Ask for | On the iPhone | What goes back to the assistant |
|---|---|---|
| "Remind me to call Grandma at 4:15" | Adds it to **Reminders**; iOS reminds them when it's due | The reminder's title, list and due time |
| "What's on my list?" / "Mark it done" | Reads or completes reminders | Titles, due times and lists |
| "What's on tomorrow?" | Reads the **Calendar** for a run of days | Event titles and times |
| "Add dinner on Friday at 7" | Adds an event to the calendar they choose | The event's title and time |
| "What's the weather?" | Gets **Apple Weather** for where they are, or a place they name | The conditions and forecast, with the place's name |
| "Where am I?" | Finds roughly where the phone is | The town, region and country |

Apple Health is separate and off until the person turns it on (see below).

Days and times are read in the phone's own time zone, and every answer carries the phone's clock, so "tomorrow at 9"
means their tomorrow.

## Apple Health

The assistant can also read a person's data in the **Health app**, and only read it: it never changes anything there.
It is off until the person turns it on in **Settings › Phone tools › Apple Health**, after an explanation, and the
person who set up the home computer has to turn it on for that profile too. A card still asks every time.

| Area | What the assistant can ask for | Until the person turns it on |
|---|---|---|
| Activity | Steps, distance, energy, exercise and stand time | Off (the Health switch) |
| Sleep | Time asleep, stages, awakenings and breathing | Off (the Health switch) |
| Heart | Resting and peak rate, heart rate variability, alerts, VO2 max | Off (the Health switch) |
| Body and vitals | Weight and other measurements, blood pressure, oxygen, glucose | Off (the Health switch) |
| Workouts | Kind, start, minutes, energy, distance and heart rate | Off (the Health switch) |
| Mindful minutes | Time spent in mindful sessions | Off (the Health switch) |
| Nutrition | Energy, macros, vitamins, minerals, water and caffeine | Off (the Health switch) |
| Mobility, hearing and daylight | Walking, sound exposure and daylight | Off (the Health switch) |
| **Cycle tracking** | Periods, cycle and fertility logs, sexual activity, pregnancy and contraception | **Off: its own switch** |
| **Moods** | How they felt and what about | **Off: its own switch** |
| **Medications** | Their medications and recent doses | **Off: its own switch** |
| **Symptoms** | What they logged and how severe | **Off: its own switch** |
| **Alcohol** | Drinks and blood alcohol | **Off: its own switch** |

- **Only a summary comes back:** numbers and their units, dates and times, workout kinds and mood labels. Never
  individual readings, the names of the apps or devices that recorded them, routes, or clinical records. A reading
  Health doesn't have is left out, never shown as zero.
- **It goes to the home computer** and stays in the chat. Whoever set up Hervi can read it, and the AI service the
  home uses sees it to answer. The assistant's memory could keep a number, though it is asked not to.
- **For a profile one person uses.** A second phone on the same profile would get the same card and could answer with
  its own Health. Give each family member their own profile ([Getting started](/docs/getting-started/)).
- **Hervi doesn't log what it was about:** Hervi and the plugin note only that a Health request came and how it ended. Hermes's own logs on the home computer may name the tool that was called, which names the area, because Hermes writes them.

To turn it on at home, set `health: true` under the profile's plugin settings (see [Getting
started](/docs/getting-started/), step 4), then restart the dashboard and start a new chat.

## What never leaves the iPhone

- **No coordinates.** Location answers the town, never the exact spot, and weather is looked up on the iPhone and
  answers with the place's name. Hervi asks iOS for approximate, while-in-use location only.
- **No notes, attendees or links** from events and reminders.
- **Health is read only,** and only what the person allowed.
- **Nothing in any log.** The app and the plugin record only which tool ran, how it ended and how long it took,
  never what was asked or answered.

## Permissions

iOS asks for each permission the first time the person taps Allow for that kind of request, never at install and
never from Settings. If they've said no to iOS before, the card explains what's off and offers **Open Settings**.
Each person can turn phone tools off in Hervi's **Settings › Phone tools**; then every request is refused at once,
with no card. Health has its own switch there, and so does each of its five private areas.

## Turning them on

Phone tools come with the Hervi plugin: install and enable it in each person's profile, and list `hervi_phone` in the
profile's tools ([Getting started](/docs/getting-started/), steps 3 and 4). Restart the dashboard, then start a **new
chat**: a chat keeps the tools it started with. In Hervi, **Settings › Phone tools** says "Ready" once the computer
has the plugin.

The plugin needs Hermes 0.22.5 or later, before 0.24, and the dashboard (`hermes serve`) running
chats in-process. Phone tools work only in chats from the Hervi app.
