scheduler

Cron expression parser and matcher. Tells you when a 5-field cron expression will fire next, when it last fired, and whether it parses at all.

Usage

native-mcp scheduler

No flags.

Cron syntax

Standard 5-field format:

* * * * *
| | | | |
| | | | +-- day of week (0-6, Sunday=0; 7 also accepted)
| | | +---- month (1-12)
| | +------ day of month (1-31)
| +-------- hour (0-23)
+---------- minute (0-59)

Each field accepts *, a number, comma-separated lists (1,2,3), ranges (1-5), or steps (*/15, 1-5/2).

When both day-of-month and day-of-week are restricted, the standard cron OR-semantics apply (the entry fires if either matches).

Tools

validate

Field	Type	Required	Description
expression	string	yes	Cron expression.

Returns valid cron expression: <field summary> or an error.

next_run

Field	Type	Required	Description
expression	string	yes	Cron expression.
after	string	no	RFC 3339 reference time (default now, UTC).

Returns the next firing time as RFC 3339 in UTC, strictly after after.

previous_run

Field	Type	Required	Description
expression	string	yes	Cron expression.
before	string	no	RFC 3339 reference time (default now, UTC).

Returns the most recent firing time before before.

Register in Claude Code

claude mcp add native-scheduler native-mcp scheduler