@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.

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

Pingfyr