Date Math
jowendelapena/date-math
Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.
- GitHub stars
- 1
- tools
- 24
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 2
- last updated
- Nov 10, 2026
Tools
24 toolsPublic tool metadata for what this MCP can expose to an agent.
date_diffDays, weeks, months and business days between two dates. Pass `country` to skip its public holidays, `workdays` for non Mon–Fri weeks.
Days, weeks, months and business days between two dates. Pass `country` to skip its public holidays, `workdays` for non Mon–Fri weeks.
No parameter schema in public metadata yet.
date_addThe date N days, weeks, months or business days before or after a date
The date N days, weeks, months or business days before or after a date
No parameter schema in public metadata yet.
timezone_convertConverts a time between IANA time zones (DST-aware)
Converts a time between IANA time zones (DST-aware)
No parameter schema in public metadata yet.
date_infoWeekday, ISO week, quarter, day of year, leap year
Weekday, ISO week, quarter, day of year, leap year
No parameter schema in public metadata yet.
public_holidaysPublic holidays for 207 countries, 2000–2050
Public holidays for 207 countries, 2000–2050
No parameter schema in public metadata yet.
working_hours_overlapWhen working hours overlap across time zones (meeting slots)
When working hours overlap across time zones (meeting slots)
No parameter schema in public metadata yet.
cron_scheduleExplains a cron expression and lists its next runs in any zone
Explains a cron expression and lists its next runs in any zone
No parameter schema in public metadata yet.
parse_date_text"next Friday at 3pm" → an exact ISO datetime
"next Friday at 3pm" → an exact ISO datetime
No parameter schema in public metadata yet.
city_timeCity name → time zone and local time (7,000+ cities)
City name → time zone and local time (7,000+ cities)
No parameter schema in public metadata yet.
recurring_datesExpands an iCal RRULE ("every 2nd Tuesday") into dates
Expands an iCal RRULE ("every 2nd Tuesday") into dates
No parameter schema in public metadata yet.
business_hours_deadlineSLA deadline N working hours from now, or working time elapsed
SLA deadline N working hours from now, or working time elapsed
No parameter schema in public metadata yet.
business_dayIs a date a business day, and if not, why (weekend or which holiday); next/previous business day; the month's business days
Is a date a business day, and if not, why (weekend or which holiday); next/previous business day; the month's business days
No parameter schema in public metadata yet.
pay_datesPayroll and billing dates (monthly, 15th and last, biweekly, weekly) moved off weekends and holidays
Payroll and billing dates (monthly, 15th and last, biweekly, weekly) moved off weekends and holidays
No parameter schema in public metadata yet.
stay_calculatorSchengen-style 90/180 stay limits: days used and left, overstay check, the longest stay from a planned entry date, the next date a full stay is possible
Schengen-style 90/180 stay limits: days used and left, overstay check, the longest stay from a planned entry date, the next date a full stay is possible
No parameter schema in public metadata yet.
timestamp_normalizeConverts up to 100 mixed timestamps (Unix s/ms/µs/ns, Excel serials, FILETIME, ISO 8601, RFC 2822, slash dates) to UTC and flags ambiguous ones like 03/04/2026
Converts up to 100 mixed timestamps (Unix s/ms/µs/ns, Excel serials, FILETIME, ISO 8601, RFC 2822, slash dates) to UTC and flags ambiguous ones like 03/04/2026
No parameter schema in public metadata yet.
dst_checkA zone's daylight-saving clock changes for a year, and whether a local time is valid, skipped (spring-forward gap) or repeated (fall-back)
A zone's daylight-saving clock changes for a year, and whether a local time is valid, skipped (spring-forward gap) or repeated (fall-back)
No parameter schema in public metadata yet.
sla_countdownLive SLA clock for support tickets: business minutes elapsed and remaining, breached or not, deadline. Pauses outside working hours, on holidays and during manual pauses
Live SLA clock for support tickets: business minutes elapsed and remaining, breached or not, deadline. Pauses outside working hours, on holidays and during manual pauses
No parameter schema in public metadata yet.
find_free_slotsMeeting slots when everyone is free: each person's working hours in their own zone (and holidays) minus their busy blocks
Meeting slots when everyone is free: each person's working hours in their own zone (and holidays) minus their busy blocks
No parameter schema in public metadata yet.
subscription_datesBilling period, next renewal, cancel-by date for a notice period, trial start and day-based proration; month-end anchors stay at month end
Billing period, next renewal, cancel-by date for a notice period, trial start and day-based proration; month-end anchors stay at month end
No parameter schema in public metadata yet.
market_calendarNYSE/Nasdaq, London and Tokyo: open now, session hours (early closes, lunch break), holidays, next open/close, settlement date (T+1/T+2)
NYSE/Nasdaq, London and Tokyo: open now, session hours (early closes, lunch break), holidays, next open/close, settlement date (T+1/T+2)
No parameter schema in public metadata yet.
date_range"last month", "this quarter", "YTD", "last 7 days", "2026-Q3" → exact start and end dates and times in a time zone, with an optional comparison period (previous period or same period last year) and fiscal years
"last month", "this quarter", "YTD", "last 7 days", "2026-Q3" → exact start and end dates and times in a time zone, with an optional comparison period (previous period or same period last year) and fiscal years
No parameter schema in public metadata yet.
business_day_scheduleHoliday-aware job schedules cron can't express: "3rd business day at 09:00", "last business day", "every Monday or the next business day", any cron with a holiday rule. Next runs plus "does it run today?"
Holiday-aware job schedules cron can't express: "3rd business day at 09:00", "last business day", "every Monday or the next business day", any cron with a holiday rule. Next runs plus "does it run today?"
No parameter schema in public metadata yet.
time_bucketsHour, day, week, month, quarter or year buckets for charts and time series, DST-aware (23- and 25-hour days), ISO or Sunday weeks, fiscal quarters
Hour, day, week, month, quarter or year buckets for charts and time series, DST-aware (23- and 25-hour days), ISO or Sunday weeks, fiscal quarters
No parameter schema in public metadata yet.
current_timeFree: the current date and time in up to 10 time zones. No payment, and it doesn't use the daily free calls
Free: the current date and time in up to 10 time zones. No payment, and it doesn't use the daily free calls
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
DATE_MATH_PRIVATE_KEYsecretOptional. Key of a wallet holding USDC on Base, to pay $0.001 per call after the 25 free daily calls.
DATE_MATH_MAX_PRICEOptional. The most to pay for one call (default $0.001).
Readme
Date Math
Exact date and time math for AI agents, paid per call. LLMs are unreliable at business days, DST, recurring schedules and holiday calendars. Date Math gives them deterministic answers over HTTP or MCP.
Details
- Repository
- github.com/jowendelapena/date-math
- Website
- github.com/JowenDelaPena/date-math
- Category
- Automation & Workflows
- Package
date-math-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
