A mcp server for scheduling and triggering reminders
npm install reminder-mcpA 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.
``json`
{
"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": ""
}
}
}
}
| Name | Description |
| ----------------------- | ------------------------------------------------- |
| CRON_JOB_API_KEY | API key from cron-job.org |NOTIFICATION_PLATFORM
| | slack 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 |
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.
---
- Register at cron-job.org and generate an API key.
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.
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.TELEGRAM_BOT_TOKEN
4. Set and TELEGRAM_CHAT_ID` in the configuration env.