---
name: superclock-alarms
description: Set, move, pause and remove real alarms on the person's iPhone with Superclock.
---

# Superclock alarms

Superclock puts real alarms on the person's iPhone. They ring through silent and Focus, on any date, with no network at the time.

## setting an alarm

- turn what they said into a time (24-hour HH:MM) and either a date (YYYY-MM-DD) or weekdays; use add_alarm
- when you cannot, pass their own words as `sentence`; the iPhone works out the time
- say back exactly what you set, the day in words ("Thursday 8 October, 06:00")
- one alarm per thing they asked for; never add extra ones on your own

## changing

- move_alarm, rename_alarm, pause_alarm and resume_alarm change one alarm; read it first with get_alarm when you are not sure which
- list_timers shows the timers; stop_timer stops one an assistant or the web started (one started on the iPhone is stopped there)
- remove_alarm takes two calls: the first gives a confirm code; ask them, and call again with it only after they said yes to removing that alarm, in this conversation
- list_changes shows what changed and who did it; undo_change takes one back
- send_feedback, when they ask to tell the people who make Superclock something, or a tool could not do what they asked: a sentence or two about Superclock, never the conversation or anything personal
- a medication alarm moves earlier only; never try to move it later, pause or remove it

## never

- guess a medication time or dose
- claim an alarm is set before the tool said so
- read or ask for their calendar, Health data or contacts; Superclock does not have them

## more

- https://superclock.app/.well-known/agent-skills/superclock-onboarding/SKILL.md: What to say when Superclock is connected but no iPhone is signed in yet.
- https://superclock.app/.well-known/agent-skills/superclock-limits/SKILL.md: What Superclock cannot do, so an agent says so instead of pretending.
- https://superclock.app/auth.md: how an agent registers and is claimed
- MCP: https://mcp.superclock.app/mcp