mcpField
R
Reminder

Reminder

Local
github.com/arifsznProductivity15Updated 39w ago
Repository

About Reminder

Reminder is an MCP server for scheduling and managing reminders delivered through Slack or Telegram. An external cron-job.org service sends notifications at the scheduled time, even when the server is not running.

Key features

  1. 01Schedule reminders
  2. 02Deliver notifications via Slack
  3. 03Deliver notifications via Telegram
  4. 04List and delete reminders
  5. 05External scheduled delivery

Use cases

  1. 01Schedule a personal follow-up
  2. 02Set a reminder for an appointment
  3. 03Review or remove an existing reminder

MCP support

Exposes reminder scheduling, listing, and deletion through an MCP server. Notifications are sent to Slack or Telegram by cron-job.org, including when the server is offline.

#productivity#slack#telegram#alert

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "reminder": {
      "command": "npx",
      "args": [
        "-y",
        "reminder-mcp"
      ],
      "env": {
        "CRON_JOB_API_KEY": "<CRON_JOB_API_KEY>",
        "NOTIFICATION_PLATFORM": "<NOTIFICATION_PLATFORM>",
        "SLACK_WEBHOOK_URL": "<SLACK_WEBHOOK_URL>",
        "TELEGRAM_BOT_TOKEN": "<TELEGRAM_BOT_TOKEN>",
        "TELEGRAM_CHAT_ID": "<TELEGRAM_CHAT_ID>"
      }
    }
  }
}
Run commandnpx -y reminder-mcp
Environment variables to set
CRON_JOB_API_KEYSecret
NOTIFICATION_PLATFORM
SLACK_WEBHOOK_URL
TELEGRAM_BOT_TOKENSecret
TELEGRAM_CHAT_ID

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmreminder-mcp

Tools

4

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

Reminder MCP Server

A MCP server for scheduling and triggering reminders via Slack or Telegram.

Reminders are delivered even if your server is not running.

This is possible because reminders are scheduled and triggered by an external service (cron-job.org), which will send the notification to Slack or Telegram at the scheduled time, regardless of your server's status.


Preview
Shadow

Configuration

{
  "mcpServers": {
    "reminder": {
      "command": "npx",
      "args": ["-y", "reminder-mcp"],
      "env": {
        "CRON_JOB_API_KEY": "your_api_key",
        "NOTIFICATION_PLATFORM": "slack",
        "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/xxxxxxx",
        "TELEGRAM_BOT_TOKEN": "",
        "TELEGRAM_CHAT_ID": ""
      }
    }
  }
}

Environment Variables

NameDescription
CRON_JOB_API_KEYAPI key from cron-job.org
NOTIFICATION_PLATFORMslack or telegram
SLACK_WEBHOOK_URL(Slack only) Webhook URL for your channel
TELEGRAM_BOT_TOKEN(Telegram only) Bot token from @BotFather
TELEGRAM_CHAT_ID(Telegram only) Chat ID for your group/user

Usage Examples

You can use natural language instructions with an LLM. Here are some examples:

  • Remind me to call Alice in 5 minutes.
  • Remind me to make a doctor appointment at 3:00 PM tomorrow.
  • List all my reminders.
  • Delete the reminder titled "Call Alice".

Note: Reminders are required to be set at least 2 minutes ahead of time.

How to Get Your Credentials

Cron Job API Key
Slack Webhook URL
  1. Go to Slack Apps.
  2. Create or select an app.
  3. Add the 'Incoming Webhooks' feature.
  4. Activate and create a webhook URL for your channel.
  5. Set SLACK_WEBHOOK_URL in the configuration env.
Telegram Bot Token & Chat ID
  1. Create a bot with @BotFather.
  2. Add your bot to your group or message it directly.
  3. Get your chat ID via the Telegram API: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates.
  4. Set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in the configuration env.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.