Agents Index

Date Math

OnlineNew

Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.

Visit publisherConnectJSON

What it can do: 24 tools

  • date_diff read-onlyHow many days, weeks, months or business days between two dates or datetimes: calendar (Y/M/D), totals, and business days (weekdays in [from, to) minus holidays; pass country to exclude its public holidays). Use for age,
  • date_add read-onlyAdd or subtract years/months/weeks/days/business days/hours/minutes/seconds from a date. Month-end clamping; business days skip weekends, given holidays, and the public holidays of an optional country. Use for due dates,
  • timezone_convert read-onlyConvert a time between time zones (IANA names like Asia/Manila, America/New_York), DST-aware. Use for "what time is 3pm Manila in New York", scheduling across zones and UTC offsets. First 25 calls per day are free, then
  • date_info read-onlyCalendar facts for a date: day of the week, ISO week number, quarter, day of year, leap year, weekend. Use for "what day is", week numbers and fiscal quarters. First 25 calls per day are free, then $0.001 per call (x402)
  • public_holidays read-onlyList public holidays (bank holidays, national holidays) for a country and year: 207 countries, 2000–2050. Use for holiday calendars, office closures and checking if a date is a holiday. Lunar or government-proclaimed dat
  • working_hours_overlap read-onlyFind when working hours overlap across time zones: the best meeting times for a distributed or remote team. Per-participant hours optional; skips weekends by default; up to 14 days. First 25 calls per day are free, then
  • cron_schedule read-onlyExplain a cron expression in plain English and list its next run times in any time zone. Use to check or debug crontab and scheduled-job schedules. First 25 calls per day are free, then $0.001 per call (x402).
  • parse_date_text read-onlyParse natural-language dates and relative times like "next Friday at 3pm", "in 2 weeks", "tomorrow morning" or "Dec 25 to Jan 2" into exact ISO datetimes, relative to a reference time and time zone. Use before acting on
  • city_time read-onlyFind the time zone and current local time in up to 10 cities by name ("Cebu", "São Paulo", "Springfield" + country). 7,000+ cities. Use for "what time is it in" questions and to get the IANA zone the other tools need. Fi
  • recurring_dates read-onlyExpand a recurring event or iCalendar RRULE ("every 2nd Tuesday", "Mon/Wed until June") into concrete dates and times in a time zone, DST-aware, with optional excluded dates. Use for repeating meetings, calendar invites
  • business_hours_deadline read-onlySLA math in working hours: the deadline N business hours after a start time, or business time elapsed between two times. Use for support-ticket SLAs, response-time targets and office-hours deadlines. Custom hours and wor
  • business_day read-onlyIs a date a business day? If not, why (weekend, or which public holiday). Also the next and previous business day, and the month's business-day count, first and last business day. Use for office-open checks, shipping cut
  • pay_dates read-onlyUpcoming pay or billing dates for monthly, semi-monthly (e.g. 15th and last day), biweekly or weekly schedules, moved off weekends and public holidays (to the previous, next or nearest business day). Use for payroll cale
  • stay_calculator read-onlyRolling stay-limit math such as the Schengen 90/180 rule: days used in the window, days left, overstay check, the longest stay allowed from a planned entry date, and the next date a full stay is possible. Entry and exit
  • timestamp_normalize read-onlyDetect and convert up to 100 mixed timestamps to UTC ISO 8601: Unix seconds/ms/µs/ns, Excel serial dates, Windows FILETIME, ISO 8601, RFC 2822, YYYY/MM/DD, month-name dates. Flags ambiguous values (03/04/2026: March 4 or
  • dst_check read-onlyDaylight saving time for a time zone: does it observe DST, the year's exact clock changes (UTC instant, local before/after), and whether a local time is valid, skipped (spring-forward gap, e.g. 02:30) or repeated (fall-b
  • sla_countdown read-onlyLive SLA clock for a support ticket: business minutes elapsed and remaining, breached or not, and the deadline. The clock pauses outside working hours, on weekends and holidays, and during manual pauses (e.g. waiting on
  • find_free_slots read-onlyFind meeting times when everyone is free: intersects each participant's working hours (own time zone, workdays, country holidays) minus their busy blocks, then lists slots of the requested length. Up to 10 people, 14 day
  • subscription_dates read-onlySubscription and contract date math: current billing period, next renewal, upcoming renewals, cancel-by date for a notice period, free-trial start, and day-based proration of a price. Month-end anchors stay at month end
  • market_calendar read-onlyStock exchange calendar for NYSE/Nasdaq, London (LSE) and Tokyo (JPX): is the market open now, today's session (early closes, lunch break), next open and close, holidays, previous/next trading day, and the trade settleme
  • date_range read-onlyTurn a reporting period into exact start and end dates and times in a time zone: "last month", "this quarter", "YTD", "MTD", "last 7 days", "next 2 weeks", "2026-Q3", "2026-W14". Optional comparison period (previous peri
  • business_day_schedule read-onlyJob schedules that skip weekends and public holidays, which cron cannot express: "3rd business day of the month at 09:00", "last business day", "every Monday, or the next business day if it is a holiday", or any cron wit
  • time_buckets read-onlySplit a time range into minute, hour, day, week, month, quarter or year buckets with exact start and end times in a time zone. DST-aware (23- and 25-hour days, repeated and skipped hours), ISO or Sunday/Saturday weeks, f
  • current_time read-onlyFree: the current date, time, weekday and UTC offset in up to 10 time zones, plus UTC and Unix time. Use when today's date or the current time is needed. Does not use the daily free calls.

Connect it

Claude Code
claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://date-math.datemath.workers.dev/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "date-math": {
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "date-math": {
      "type": "http",
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

Questions

What does Date Math do?

Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day. It exposes 24 tools to AI assistants.

What tools does Date Math provide?

24 tools, including date_diff, date_add, timezone_convert, date_info, public_holidays, working_hours_overlap, cron_schedule, parse_date_text, city_time, recurring_dates, business_hours_deadline, business_day….

How do I connect Date Math to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://date-math.datemath.workers.dev/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Date Math require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Date Math online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Date Math?

@JowenDelaPena on GitHub. The official MCP Registry verified that the publisher controls this GitHub account before accepting the listing.

Similar in Agents & Orchestration