Reminder

@arifszn

About Reminder

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

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

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

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Productivity MCP servers

AdWhispr - Research, Clone, & Launch Ads from Claude/ChatGPT

AdWhispr

Remote MCP server that turns Claude, ChatGPT, or Cursor into a full ad workflow: research any brand's live Facebook and TikTok ads, clone the proven winners for your own brand, and launch real campaigns on Google, TikTok