Pingfyr

@pingfyr/mcp

MCP 経由で AI アシスタントを Pingfyr に接続します。自然な会話を通じてリマインダーを管理できます。

1 回の API 呼び出しで、7 つのチャネルに対応します。リマインダーは自動的に通知されるため、外部の cron もポーリングも見守りも不要です。

ローカルの npm パッケージとして、または mcp.pingfyr.com のホスト型サーバーとして利用できます。ローカルへのインストールは不要です。

インストール

npm install -g @pingfyr/mcp

または、npx で直接実行します。

npx @pingfyr/mcp

設定

ローカル設定（stdio）

MCP サーバーをローカルプロセスとして実行します。Node.js 18 以降が必要です。

MCP クライアントの設定（Claude Code、Cursor、Windsurf など）に追加します。

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

API キーを取得するには、pingfyr.com で登録してください。

ホスト型サーバーの設定

インストールは不要です。HTTP トランスポートを使用して mcp.pingfyr.com に直接接続します。リクエストごとに API キーが Bearer トークンとして送信されます。

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

HTTP トランスポートは Claude Code と Cursor でサポートされています。Claude Desktop では、上記のローカル（stdio）オプションが必要です。

利用可能なツール

ツール	説明
create_reminder	メール、Webhook、Slack、Discord、Telegram、OpenClaw、Google Calendar 経由で新しいリマインダーを予約します
list_reminders	ステータス、件数、オフセットで絞り込み、すべてのリマインダーを一覧表示します
update_reminder	保留中のリマインダーを更新します（タイトル、本文、fire_at、チャネル、宛先、繰り返し、タイムゾーン）
cancel_reminder	保留中のリマインダーをキャンセルします

create_reminder のパラメーター

パラメーター	必須	型	説明
title	はい	string	リマインダーのタイトル（最大 200 文字）
fire_at	はい	string	通知する日時（ISO 8601 形式の日時。未来の日時である必要があります）
channel	はい	enum	email、webhook、slack、discord、telegram、openclaw、google_calendar
recipients	はい	string[]	配信先アドレス（チャネルごとの形式は「チャネル」表を参照）
body	いいえ	string	リマインダーの本文・説明（最大 2000 文字）
repeat	いいえ	enum	daily、weekly、monthly、custom
cron_expression	いいえ	string	Cron 式（repeat が custom の場合に必須）
timezone	いいえ	string	繰り返しリマインダーの IANA タイムゾーン（デフォルト：UTC）
metadata	いいえ	object	リマインダーに付加する任意のキーと値のメタデータ

list_reminders のパラメーター

パラメーター	必須	型	説明
status	いいえ	enum	pending、processing、delivered、failed、cancelled
limit	いいえ	number	結果の最大件数（デフォルト：50、最大：100）
offset	いいえ	number	ページネーションのオフセット（デフォルト：0）

update_reminder のパラメーター

パラメーター	必須	型	説明
id	はい	string	更新するリマインダーの UUID
title	いいえ	string	新しいタイトル
body	いいえ	string	新しい本文
fire_at	いいえ	string	新しい通知時刻（ISO 8601）
channel	いいえ	enum	新しいチャンネル
recipients	いいえ	string[]	更新後の配信先アドレス
repeat	いいえ	enum	新しい繰り返しスケジュール（削除する場合は null）
timezone	いいえ	string	新しいタイムゾーン

例

メールリマインダー（複数の宛先）

{
  "title": "Project deadline reminder",
  "fire_at": "2026-12-15T08:00:00Z",
  "channel": "email",
  "recipients": ["[email protected]", "[email protected]"]
}

Slack リマインダー

{
  "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 通知

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

Telegram リマインダー

{
  "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"
}

Pingfyr ダッシュボードの「Settings → Telegram Bots」で bot_id を確認してください。

OpenClaw 通知

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

Google Calendar の予定（Starter+ プランが必要）

ユーザーが接続した Google アカウントに Google Calendar の予定を作成します。 Pingfyr ダッシュボードの「Settings → Google Calendar」でアカウントを接続してください。

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

Webhook（エージェントの起動）

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

カスタム cron スケジュール

{
  "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"
}

チャンネル

チャンネル	recipients の形式	説明
email	メールアドレス	1 つ以上のメール受信トレイに配信します（Starter+ プランが必要）
webhook	HTTP/HTTPS URL	エージェントを起動するための POST リクエスト
slack	Slack Incoming Webhook URL	Slack チャンネルにメッセージを投稿します
discord	Discord Webhook URL	Discord チャンネルにメッセージを投稿します
telegram	bot:<bot_id>:<chat_id>	Telegram ボット経由でメッセージを送信します（「Settings → Telegram Bots」でボットを登録）
openclaw	OpenClaw URL	OpenClaw エンドポイントへの POST リクエスト
google_calendar	google（リテラル）	接続済みアカウントに Google Calendar の予定を作成します（Starter+ プランが必要）

プラン

プラン	価格	月間リマインダー数	月間宛先数
Free	$0	50	100
Starter	$59/mo	10,000	20,000
Pro	$269/mo	50,000	100,000
Enterprise	お問い合わせ	無制限	無制限

Free プランには、Webhook、Slack、Discord、Telegram、OpenClaw の各チャンネルが含まれます。Email と Google Calendar の利用には有料プラン（Starter+）が必要です。

環境変数

変数	必須	説明
PINGFYR_API_KEY	はい	Pingfyr API キー
PINGFYR_API_URL	いいえ	API のベース URL（デフォルト：https://pingfyr.com）

ライセンス

MIT