Run a GitHub Actions workflow on the first Monday of every month
GitHub Actions has no exact expression for “First Monday of the month”. Here is why, a workaround, and the platforms that can do it. GitHub Actions takes POSIX cron in on.schedule and runs it on the default branch, in UTC unless the entry sets a time zone.
Why GitHub Actions can’t do this exactly
Defined on Quartz as 0 0 9 ? * 2#1 · “At 09:00, on the first Monday of the month”
day of week: GitHub Actions has no “nth weekday of the month” (2#1).
WorkaroundRun on the day-of-month part and exit in the job unless it is the right weekday.
Not equivalent on its own: it needs a check inside the job.0 9 1-7 * * # job: [ "$(date +%w)" = "1" ] || exit 0
GitHub Actions gotchas
FAQ
What is the GitHub Actions cron expression for “First Monday of the month”?
There is none that matches exactly. GitHub Actions has no “nth weekday of the month” (2#1).
Which time zone does a GitHub Actions schedule use?
In UTC by default. Add timezone: with an IANA name, such as Asia/Tokyo, next to cron: in the schedule entry.
Can GitHub Actions run every minute?
No. The documented minimum is every 5 minutes. For tighter intervals, trigger the workflow from outside with workflow_dispatch or repository_dispatch.
Does GitHub Actions support @hourly or @daily?
No. GitHub does not support @yearly, @monthly, @weekly, @daily, @hourly or @reboot. Use the five fields.