Claude Code notifications on your iPhone

How it works

• Claude Code runs hooks on its own events: Stop when a turn finishes and Notification when it asks for permission or input. The alert does not depend on the model remembering to send it.
• The AgentAlarm hook turns those events into a quiet notification on your iPhone: “Claude Code: task finished in my-app” or “Claude Code needs your decision in my-app”.
• No spam: it alerts only while you are away from the computer (after 2 idle minutes), says “task finished” only for turns of at least 3 minutes, and sends at most one alert per session every 5 minutes.
• Alerts carry the project folder name and the task length. Never your prompt, code or Claude’s output.

Set it up with the plugin

1. Install AgentAlarm on your iPhone and sign in with Apple.
2. In Claude Code, add the plugin:

   /plugin marketplace add achubnet/agentalarm-plugins
   /plugin install agentalarm@agentalarm

3. Run /agentalarm:setup. Claude walks you through connecting the MCP tools (type /mcp, choose agentalarm, Authenticate, approve on your iPhone) and a key for the hooks.
4. Finish with a test: your iPhone gets a notification.

Or add the hooks yourself

Prefer plain hooks without a plugin? Sign the CLI in once (Node 18 or later). In the app, open Settings → Connected Agents → Connect, copy the text, then run:

npx agentalarm login "<the text copied from the app>"

Then add this to ~/.claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Stop": [{ "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }],
    "Notification": [{ "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog|agent_needs_input",
      "hooks": [{ "type": "command", "command": "npx -y agentalarm hook claude-code", "async": true }] }]
  }
}

The hooks run in the background, so Claude never waits for them. UserPromptSubmit only notes when a turn starts, so the hook can tell how long it ran. A global install (npm i -g agentalarm, then agentalarm hook claude-code) starts faster than npx.

Ring me when it’s done

With the MCP tools connected, just ask in the chat:

• “Ring me when the tests pass.”
• “Ring my iPhone if the migration fails.”
• “Remind me at 6 pm to review this PR.”

An urgent alert rings your iPhone like an alarm clock, through Silent mode and Focus, until you tap Done or Snooze. To make every “needs your decision” alert ring, run npx agentalarm config set ringOnDecision true.

On your Apple Watch

AgentAlarm notifications show up on your Apple Watch like other iPhone notifications do while your iPhone is locked, so a finished task taps your wrist. Check Watch app → Notifications → AgentAlarm if they don’t.

Tune or pause it

npx agentalarm setup              # when the hooks alert you
npx agentalarm config set minTaskMinutes 10
npx agentalarm pause 1h           # then: npx agentalarm resume
npx agentalarm test               # rings your iPhone once

Quiet hours turn rings from hooks into plain notifications, for example npx agentalarm config set quietHours 23:00-08:00.