mcp server

reminder-mcp

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

arifszn/reminder-mcpcommunitylistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "arifszn-reminder-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "reminder-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

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.

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

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

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

Go to Slack Apps.
Create or select an app.
Add the 'Incoming Webhooks' feature.
Activate and create a webhook URL for your channel.
Set SLACK_WEBHOOK_URL in the configuration env.

Telegram Bot Token & Chat ID

Create a bot with @BotFather.
Add your bot to your group or message it directly.
Get your chat ID via the Telegram API: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates.
Set TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID in the configuration env.