Reminder

Name: Reminder
Author: arifszn

@arifszn

リポジトリ

Reminder について

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

#productivity #slack #telegram #alert

基本情報

カテゴリ

生産性

トランスポート

stdio

公開者

arifszn

投稿者

Ariful Alam

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

Get all reminders

Get the current local time

Create a reminder You MUST call this function before 'get-current-time' to obtain the current time.

Delete reminders by title, processed, or all

概要

What is Reminder?

Reminder is an MCP server that schedules and triggers reminders delivered via Slack or Telegram. Reminders are executed by an external service (cron-job.org), so they are sent even if the server is not running.

How to use Reminder?

Configure the server in your MCP client with the reminder-mcp package, setting the required environment variables (CRON_JOB_API_KEY, NOTIFICATION_PLATFORM, and either Slack or Telegram credentials). Invoke reminders using natural language instructions through an LLM, for example: "Remind me to call Alice in 5 minutes."

Key features of Reminder

Reminders delivered via Slack or Telegram.
Uses cron-job.org for reliable, server‑independent scheduling.
Natural language creation, listing, and deletion of reminders.
Reminders must be scheduled at least 2 minutes ahead of time.

Use cases of Reminder

Schedule a reminder to call a contact in a few minutes.
Set a reminder for a doctor appointment at a specific time tomorrow.
List all currently active reminders.
Delete a specific reminder by its title.

FAQ from Reminder

What happens if my server goes offline?

Reminders are still delivered because they are scheduled and triggered by cron-job.org, which sends the notification directly to Slack or Telegram regardless of your server’s status.

How far in advance must a reminder be set?

Reminders must be set at least 2 minutes ahead of the desired time.

What credentials do I need?

You need a cron-job.org API key, choose a notification platform (slack or telegram), and then either a Slack webhook URL or a Telegram bot token and chat ID. Detailed instructions are provided in the README.

Can I use both Slack and Telegram simultaneously?

No—you set a single NOTIFICATION_PLATFORM environment variable to either slack or telegram. Only one platform can be active per server instance.