https://github.com/arifszn/reminder-mcp
A MCP server for scheduling and triggering reminders via Slack or Telegram.
https://github.com/arifszn/reminder-mcp
Last synced: 3 months ago
JSON representation
A MCP server for scheduling and triggering reminders via Slack or Telegram.
- Host: GitHub
- URL: https://github.com/arifszn/reminder-mcp
- Owner: arifszn
- License: mit
- Created: 2025-07-08T05:46:14.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-09T11:31:07.000Z (4 months ago)
- Last Synced: 2025-08-09T15:02:06.116Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 47.9 KB
- Stars: 11
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Reminder - MCP server for scheduling and triggering reminders via Slack or Telegram. (Community Servers)
- awesome-mcp-servers - **Reminder** - MCP server for scheduling and triggering reminders via Slack or Telegram. `http` `git` `github` `slack` `telegram` (📦 Other)
README
# 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
```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": ""
}
}
}
}
```
## Environment Variables
| Name | Description |
| ----------------------- | ------------------------------------------------- |
| `CRON_JOB_API_KEY` | API key from [cron-job.org](https://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](https://cron-job.org) and generate an API key.
### Slack Webhook URL
1. Go to [Slack Apps](https://api.slack.com/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](https://t.me/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/getUpdates`.
4. Set `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID` in the configuration env.