Reminder
About
MCP server for scheduling and triggering reminders via Slack or Telegram.
Details
- Author
- arifszn
- Downloads
- 321
- Categories
- Other, Productivity
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ReminderCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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."
get-reminders
Get all reminders
get-current-time
Get the current local time
create-reminder
Create a reminder You MUST call this function before 'get-current-time' to obtain the current time.
delete-reminder
Delete reminders by title, processed, or all
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"reminder": {
"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": ""
}
}
}
}
}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": ""
}
}
}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.
<br/>
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
- Register at cron-job.org and generate an 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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
