@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

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)

... View full README on GitHub