A push notification MCP server for your iPhone

The server

• URL: https://alarm.achub.net/mcp (Streamable HTTP).
• Sign-in: OAuth 2.1 with dynamic client registration. The sign-in page shows a QR code and a short code that you approve in the AgentAlarm app. No API key to paste.
• Each agent gets its own key, listed in the app under Settings → Connected Agents, where you can disconnect it.

Connect your agent

Claude Code:

claude mcp add --transport http agentalarm https://alarm.achub.net/mcp

Cursor (~/.cursor/mcp.json) and most other clients:

{ "mcpServers": { "agentalarm": { "url": "https://alarm.achub.net/mcp" } } }

VS Code (.vscode/mcp.json):

{ "servers": { "agentalarm": { "type": "http", "url": "https://alarm.achub.net/mcp" } } }

A client without remote OAuth can run the local bridge npx -y agentalarm mcp after npx agentalarm login. Steps for every client: Connect AgentAlarm to your AI agent.

The tools

• alert: a notification now, a reminder with at, or a ring with ring: true. Optional body, color, icon, sound, place and countdown. It only reaches your own iPhone.
• list_alarms: upcoming reminders and the notifications of the last 24 hours, with your time zone. Read-only.
• update_alarm and cancel_alarm: change or stop a reminder.
• rename_agent: the name the app shows for the agent.

A ring, as the agent sends it:

{ "name": "alert", "arguments": { "title": "Deploy failed: api", "ring": true } }

What to ask

• “Ring my iPhone if the deploy fails.”
• “Notify me when this long task finishes.”
• “Remind me at 7:30 tomorrow to send the report.”
• “What reminders do I have today?”

An urgent alert rings like an alarm clock, through Silent mode and Focus, until you tap Done or Snooze. Everything else arrives as a normal notification.

From scripts and CI

The same alerts work without an agent:

npx agentalarm "Backup finished"
npx agentalarm "Deploy failed" --ring --color red

More examples (GitHub Actions, cron, deploy scripts) are in the plugins README.

Limits and safety

Daily limits keep a runaway agent from flooding your phone; the agent gets a clear message when it hits one. AgentAlarm is not for safety-critical or medical alarms: delivery depends on your network, your iPhone settings and Apple’s services.