ReminderBot
A fully-featured Telegram Bot built on Cloudflare Workers. Manage reminders, events, and tasks with multi-calendar support.
Serverless & Scalable
ReminderBot runs entirely on the Cloudflare Edge. It utilizes Cloudflare Workers for instant responses and KV storage for persistent, low-latency data access.
Built with JavaScript, it handles complex logic like multi-calendar conversions (Jalali, Hijri, Hebrew) and scheduled tasks via Cron Triggers without a traditional server.
Why Use ReminderBot?
Multi-Calendar
Supports Gregorian, Jalali, Hijri, Hebrew, Chinese, and Hindu Saka calendars for diverse users.
Smart Reminders
Set quick timers (10m), specific dates, or daily recurring reminders with natural language commands.
Custom Events
Create personalized events for birthdays or anniversaries and get notified automatically.
Timezone Aware
Full IANA timezone support ensures you get notified at the exact right time, anywhere in the world.
Privacy First
Data stored in secure Cloudflare KV. No third-party tracking or ads.
To-Do Integration
Syncs with To-Do Bot to manage your tasks and reminders in one place.
Deployment
Quick Deploy
Clone, install dependencies, and deploy using Wrangler CLI:
Configuration
Ensure you have your wrangler.toml configured with your KV bindings and schedule triggers.
Bot Commands
| Command | Action | Description |
|---|---|---|
/start | Initialize | Starts the bot and sets up basic data. Supports deep links (e.g., ?start=tz_Europe/London). |
/remind | Reminder | Interactive reminder setup. Supports quick timers (e.g., /remind 10m) or specific dates. |
/subscribe | Events | Subscribe to daily event notifications at a specific time (e.g., /subscribe 09:00). |
/events | Browse | Toggle event packs (Gregorian, Jalali, etc.) and enable/disable specific holidays. |
/addevent | Custom | Add a custom event (e.g., birthday) to your personal calendar. |
/timezone | Settings | Set your IANA timezone for accurate reminder timing. |
/todo | Tasks | View your active tasks from the linked To-Do Bot. |
/broadcast | Admin | Send a message to all users (Admin only). |
Workflow Examples
⏱️ Quick Timer
Set a quick relative timer. The bot will notify you after the duration expires.
📅 Specific Date
Set a reminder for a specific date and time. Requires timezone setup first.
🌍 Timezone Setup
Pick your timezone from an interactive region menu to ensure accurate scheduling.
🔔 Event Subscription
Subscribe to daily notifications and choose which event packs (Jalali, Hijri, etc.) to follow.
Ready to deploy your own bot? 🚀
Get ReminderBot on GitHub