for developers

Let your agent
set the alarm.

LFG rings real alarms on iPhone, Android and the web, for one person or a whole group. Your AI agent can set them through the MCP server, anything that can send a request can ring one through an Anything link, and your own code can do both with the SDK.

three ways in

Pick yours.

1. mcp server

Your AI app sets the alarm.

One address: https://mcp.lfg.gm. Add it as a connector, sign in once with your LFG account, then ask in plain words: "wake me and my friends at 6 on weekdays". Your agent sets the alarm, shares it, changes it or switches it off, and the phones ring.

Claude Code
claude mcp add --transport http --scope user lfg-alarm https://mcp.lfg.gm
Cursor, and any app with a JSON config
{
  "mcpServers": {
    "lfg-alarm": { "url": "https://mcp.lfg.gm" }
  }
}
  • Remote server over Streamable HTTP, nothing to install.
  • Most AI apps open an LFG sign-in page when you add it. Sign in once and you are done.
  • Claude and ChatGPT: add it as a custom connector with the address above.

No sign-in page, like a script or your own agent? Make a personal key in the app under Settings, AI apps and keys, and send it with every request in this header. Your key starts with lfg_pat_.

Authorization: Bearer YOUR_KEY
3. for event pages

Let your guests set an alarm.

Calendars are full. An RSVP is easy to forget, and a calendar invite just sits there. An alarm rings. So when someone sets an alarm for your event, they really mean to come.

Add a Set an LFG alarm button next to Add to calendar, on your event page or in your ticket email. It's one link: no account, no key, nothing to install. A guest taps it, LFG opens on your event, and they pick how early it rings. Their friends can join the same alarm and wake up together.

The easy way: link to your event page
https://lfg.gm/add?url=https%3A%2F%2Fexample.com%2Fevents%2Frooftop-party
Or write the event details into the link
https://lfg.gm/add?title=Rooftop%20Party&start=2026-11-14T20:00:00-08:00&location=Los%20Angeles&url=https%3A%2F%2Fexample.com%2Fevents%2Frooftop-party
  • The easy way works with any public event page, like Luma, Partiful, Eventbrite or Posh. We read the name, time, place and picture from it.
  • To write the details yourself, give a title and a start: the exact time with its time zone, like 2026-11-14T20:00:00-08:00. You can add a location, an image (https only) and a description.
  • Encode each value, as you would in any web address.
  • The link never sets an alarm on its own. Your guest always picks how early it rings and taps Create alarm.
  • Guests without the app see your event on lfg.gm and where to get the app. Once they install it, your event is waiting.
Set an LFG alarmSet an LFG alarmSet an LFG alarmSet an LFG alarm
On your event page
<a href="https://lfg.gm/add?url=YOUR_EVENT_PAGE">
  <img src="https://lfg.gm/badges/lfg/set-lfg-alarm-black.svg"
       alt="Set an LFG alarm" height="44">
</a>
In an email
<a href="https://lfg.gm/add?url=YOUR_EVENT_PAGE">
  <img src="https://lfg.gm/badges/lfg/[email protected]"
       alt="Set an LFG alarm" width="185" height="44">
</a>

Pick a colour: black, white, violet or volt. Each comes as an SVG for web pages (/badges/lfg/set-lfg-alarm-black.svg) and as a PNG for emails ([email protected]), since most email apps can't show SVG. Please keep the words and the logo as they are.

4. the sdk

Everything, from your own code.

ring(url) calls an Anything link, no key needed. LfgAlarm sets, changes and deletes alarms with a personal key from the app. Small, open source, no dependencies.

JavaScript

npm install lfg-alarm
import { ring } from 'lfg-alarm';

// Build failed? Ring the on-call phone.
// The address is the alarm's Anything link from the app.
await ring('https://api.lfg.gm/horn/your-token');

Python

pip install lfg-alarm
from lfg_alarm import LfgAlarm

# Gym at 7 on Mondays and Fridays.
alarms = LfgAlarm()  # reads LFG_API_KEY
alarms.set_time_alarm(
    "07:00", "Europe/London",
    repeat_days=["mon", "fri"],
    title="Gym",
)
vercel ai sdk

Give your agent the alarm tools.

lfg-alarm/ai hands an AI SDK agent every LFG tool, read live from the server so they are always current. Pass only to give it a few, like ['set_time_alarm', 'list_my_links']. Works with AI SDK 5 and later.

npm install lfg-alarm ai
Set alarms (personal key)
import { generateText, isStepCount } from 'ai';
import { lfgAlarmTools } from 'lfg-alarm/ai';

const { text } = await generateText({
  model: 'openai/gpt-5-mini',
  prompt: 'Wake me at 7 on weekdays with something upbeat. I am in London.',
  tools: await lfgAlarmTools(), // reads LFG_API_KEY
  stopWhen: isStepCount(3),
});
Ring a phone when the job is done (no key)
import { ringPhone } from 'lfg-alarm/ai';

// No key: rings the Anything alarm at LFG_RING_URL.
tools: { ringPhone: ringPhone(), ...yourTools }
more ways in

Already where you build.

Ready-made for the tools people already use. Each one runs on the MCP server or an Anything link above, so the same rules apply.

LangChain (Python)
pip install langchain-lfg
GitHub Actions: ring when a workflow fails
- if: failure()
  uses: lfg-gm/ring-action@v1
  with:
    ring-url: ${{ secrets.LFG_RING_URL }}
Node-RED (or Manage palette in the editor)
npm install @lfgdotgm/node-red-lfg-alarm
Claude Code plugin: the server plus the skill
/plugin install lfg-alarm --marketplace lfg-gm/lfg-alarm-mcp
Gemini CLI extension
gemini extensions install https://github.com/lfg-gm/lfg-alarm-mcp
OpenClaw skill
openclaw skills install @lfg/lfg-alarm
bring your own agent

Whatever you run. Rocco takes the call.

Tell your agent the moment in your own words. It makes the alarm, Rocco keeps watch, and everyone who joins gets woken. An alarm rings out loud, so it gets noticed where one more notification would be muted.

GrokMuseDotOpenClawHermesand the rest
Rocco

Build it.
Rocco rings it.

Connect your AI app, call the link, or install the SDK. Rocco rings every phone on the alarm.