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
Or run directly with npx:
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.):
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.
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) |
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 |