@pingfyr/mcp — MCP Server for Pingfyr Reminder API

Schedule reminders via API. Wake your agents via webhook. Deliver notifications via email, Slack, Discord, Telegram, OpenClaw, or Google Calendar.

What is Pingfyr?

Pingfyr is a reminder service built for AI agents. It lets your agent schedule reminders that get delivered at the right time — via email to humans, via webhook to wake up other agents, or via Slack, Discord, Telegram, OpenClaw, and Google Calendar for team notifications.

No cron jobs. No infrastructure. Just tell your agent when to remind, and Pingfyr handles the rest.

Installation

npm install -g @pingfyr/mcp

Or run directly with npx:

npx @pingfyr/mcp

Configuration

Claude Code (~/.claude/mcp.json)

{
  "mcpServers": {
    "pingfyr": {
      "command": "pingfyr-mcp",
      "env": {
        "PINGFYR_API_KEY": "rm_your_api_key",
        "PINGFYR_API_URL": "https://pingfyr.com"
      }
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS)

{
  "mcpServers": {
    "pingfyr": {
      "command": "npx",
      "args": ["-y", "@pingfyr/mcp"],
      "env": {
        "PINGFYR_API_KEY": "rm_your_api_key",
        "PINGFYR_API_URL": "https://pingfyr.com"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client (Cursor, Windsurf, etc.) can use the same configuration pattern above.

Sign up at pingfyr.com to get your API key.

Available Tools

Tool	Description
create_reminder	Schedule a new reminder via email, webhook, Slack, Discord, Telegram, OpenClaw, or Google Calendar
list_reminders	List all reminders with optional filtering by status, limit, and offset
update_reminder	Update a pending reminder (title, body, fire_at, channel, recipients, repeat, timezone)
cancel_reminder	Cancel a pending reminder

create_reminder Parameters

Parameter	Required	Type	Description
title	Yes	string	Title of the reminder (max 200 chars)
fire_at	Yes	string	When to fire (ISO 8601 datetime, must be in the future)
channel	Yes	enum	email, webhook, slack, discord, telegram, openclaw, google_calendar
recipients	Yes	string[]	Delivery addresses (see Channels table for format per channel)
body	No	string	Body/description of the reminder (max 2000 chars)
repeat	No	enum	daily, weekly, monthly, custom
cron_expression	No	string	Cron expression (required when repeat is custom)
timezone	No	string	IANA timezone for recurring reminders (default: UTC)
metadata	No	object	Arbitrary key-value metadata to attach to the reminder

list_reminders Parameters

Parameter	Required	Type	Description
status	No	enum	pending, processing, delivered, failed, cancelled
limit	No	number	Max results (default: 50, max: 100)
offset	No	number	Pagination offset (default: 0)

update_reminder Parameters

Parameter	Required	Type	Description
id	Yes	string	UUID of the reminder to update
title	No	string	New title
body	No	string	New body
fire_at	No	string	New fire time (ISO 8601)
channel	No	enum	New channel
recipients	No	string[]	Updated delivery addresses
repeat	No	enum	New repeat schedule (null to remove)
timezone	No	string	New timezone

Examples

Email reminder (multi-recipient)

{
  "title": "Project deadline reminder",
  "fire_at": "2026-12-15T08:00:00Z",
  "channel": "email",
  "recipients": ["alice@example.com", "bob@example.com"]
}

Slack reminder

{
  "title": "Weekly team sync reminder",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "slack",
  "recipients": ["https://hooks.slack.com/services/T.../B.../xxx"],
  "repeat": "weekly",
  "timezone": "America/New_York"
}

Discord notification

{
  "title": "Deploy notification",
  "fire_at": "2026-12-01T17:00:00Z",
  "channel": "discord",
  "recipients": ["https://discord.com/api/webhooks/xxx/yyy"]
}

Telegram reminder

{
  "title": "Daily standup",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "telegram",
  "recipients": ["bot:123456:789012"],
  "repeat": "daily",
  "timezone": "Europe/Berlin"
}

Find your bot_id in Settings → Telegram Bots on the Pingfyr dashboard.

OpenClaw notification

{
  "title": "Agent task complete",
  "fire_at": "2026-12-01T10:00:00Z",
  "channel": "openclaw",
  "recipients": ["https://openclaw.example.com/webhook"]
}

Google Calendar event (Starter+ plan required)

Creates a Google Calendar event on the user's connected Google account. Connect your account at Settings → Google Calendar in the Pingfyr dashboard.

{
  "title": "Team sync",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "google_calendar",
  "recipients": ["google"]
}

Webhook (agent wake-up)

{
  "title": "Check for new orders",
  "fire_at": "2026-12-01T10:00:00Z",
  "channel": "webhook",
  "recipients": ["https://your-agent.example.com/webhook"],
  "repeat": "daily"
}

Custom cron schedule

{
  "title": "Weekday morning check",
  "fire_at": "2026-12-01T09:00:00Z",
  "channel": "webhook",
  "recipients": ["https://your-agent.example.com/webhook"],
  "repeat": "custom",
  "cron_expression": "0 9 * * MON-FRI",
  "timezone": "America/New_York"
}

Channels

Channel	recipients format	Description
email	Email addresses	Deliver to one or more email inboxes (Starter+ plan required)
webhook	HTTP/HTTPS URL	POST request to wake up agents
slack	Slack Incoming Webhook URL	Post message to a Slack channel
discord	Discord Webhook URL	Post message to a Discord channel
telegram	bot:<bot_id>:<chat_id>	Send message via Telegram bot (register bot in Settings → Telegram Bots)
openclaw	OpenClaw URL	POST request to an OpenClaw endpoint
google_calendar	google (literal)	Create a Google Calendar event on your connected account (Starter+ plan required)

Plans

Plan	Price	Reminders/month	Recipients/month
Free	$0	50	100
Starter	$59/mo	10,000	20,000
Pro	$269/mo	50,000	100,000
Enterprise	Contact	Unlimited	Unlimited

Free plan includes Webhook, Slack, Discord, Telegram, and OpenClaw channels. Email and Google Calendar require a paid plan (Starter+).

Environment Variables

Variable	Required	Description
PINGFYR_API_KEY	Yes	Your Pingfyr API key
PINGFYR_API_URL	No	API base URL (default: https://pingfyr.com)

License

MIT