Pingfyr MCP Server

@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

create_reminder Parameters

list_reminders Parameters

update_reminder Parameters

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

Plans

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

Environment Variables

License

MIT