Pingfyr

@pingfyr/mcp

Connect your AI assistant to Pingfyr via MCP. Manage reminders through natural conversation.

One API call. Seven channels. Your reminders fire automatically — no external cron, no polling, no babysitting.

Available as a local npm package or as a hosted server at mcp.pingfyr.com — no local install required.

Installation

npm install -g @pingfyr/mcp

Or run directly with npx:

npx @pingfyr/mcp

Configuration

Local Setup (stdio)

Run the MCP server as a local process. Requires Node.js 18+.

Add to your MCP client config (Claude Code, Cursor, Windsurf, etc.):

{

"mcpServers": { "pingfyr": { "command": "pingfyr-mcp", "env": { "PINGFYR_API_KEY": "rm_your_api_key" } } } }

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

Hosted Setup

No install required. Connect directly to mcp.pingfyr.com using HTTP transport. Your API key is sent as a Bearer token per request.

{

"mcpServers": { "pingfyr": { "type": "http", "url": "https://mcp.pingfyr.com", "headers": { "Authorization": "Bearer rm_your_api_key" } } } }

HTTP transport is supported by Claude Code and Cursor. Claude Desktop requires the local (stdio) option above.

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:your-bot-uuid:your-chat-id"], "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