Notion Study Reminder

A schedule that reaches me

I already kept my study schedule in Notion, but it only helped when I remembered to open it. Notion Study Reminder turns that passive page into a small, predictable email routine.

The service reads unchecked to-do blocks recursively and also supports database-style tasks. It combines today's checklist with nearby deadlines, then sends the result through Gmail.

Three runs, two useful shapes

Morning and evening messages contain today's checklist plus non-overdue deadlines inside a configurable seven-day window. The midday message is deliberately quieter: it contains only work due today and sends nothing when that list is empty.

Beirut time without a brittle cron table

GitHub Actions wakes the script hourly. The Node process decides whether a reminder is due by comparing the current time in Asia/Beirut, so daylight-saving changes do not require editing the workflow schedule. A small send marker prevents the same scheduled window from producing duplicate mail.

A dependency-free implementation

The project uses the Node 18 standard library for HTTP requests, date handling, environment configuration, and MIME message construction. It can send through Gmail SMTP or the Gmail API with OAuth, and it handles paginated Notion responses plus the transition between older database endpoints and newer data-source endpoints.

Edges I would tighten

The current parser expects specific Notion property names, so a mapping layer would make it friendlier to other workspaces. Dynamic text should also be escaped before entering the HTML email, and the scheduler could compare exact minutes rather than relying on hourly workflow timing. The current test suite covers the parsing and scheduling behavior with 18 passing tests.