io.github.JowenDelaPena/date-math

up checked 2026-11-11T17:37:45.711Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Date Math

Publisher-provided description

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

Summary by lookupd

Date and time calculations for agents: business days, holidays, time zones, cron schedules, recurring events and SLA deadlines.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp

Claude Code, npm package (stdio)

claude mcp add date-math -- npx -y date-math-mcp

Codex, remote (streamable-http)

codex mcp add date-math --url https://date-math.datemath.workers.dev/mcp

Codex, npm package (stdio)

codex mcp add date-math -- npx -y date-math-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "date-math": {
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "date-math": {
      "command": "npx",
      "args": [
        "-y",
        "date-math-mcp"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (24 tools)

Publisher-provided text

• date_diff How 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
• date_add Add or subtract years/months/weeks/days/business days/hours/minutes/seconds from a date. Month-end clamping; business days skip weekends, given holidays, and th
• timezone_convert Convert 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 z
• date_info Calendar 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.
• public_holidays List public holidays (bank holidays, national holidays) for a country and year: 207 countries, 2000–2050. Use for holiday calendars, office closures and checkin
• working_hours_overlap Find when working hours overlap across time zones: the best meeting times for a distributed or remote team. Per-participant hours optional; skips weekends by de
• cron_schedule Explain 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 cal
• parse_date_text Parse 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, relat
• city_time Find 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"
• recurring_dates Expand 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 e
• business_hours_deadline SLA 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-t
• business_day Is 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
• pay_dates Upcoming 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 p
• stay_calculator Rolling 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
• timestamp_normalize Detect 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, mont
• dst_check Daylight 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,
• sla_countdown Live SLA clock for a support ticket: business minutes elapsed and remaining, breached or not, and the deadline. The clock pauses outside working hours, on weeke
• find_free_slots Find meeting times when everyone is free: intersects each participant's working hours (own time zone, workdays, country holidays) minus their busy blocks, then
• subscription_dates Subscription and contract date math: current billing period, next renewal, upcoming renewals, cancel-by date for a notice period, free-trial start, and day-base
• market_calendar Stock 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,
• date_range Turn 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", "202
• business_day_schedule Job 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, o
• time_buckets Split 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,
• current_time Free: 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 n

Details

• Version: 1.8.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 342 ms
• First indexed: 2026-11-07T11:17:20.246Z
• Last seen in registry: 2026-11-10T14:17:28.827Z
• Repository: https://github.com/JowenDelaPena/date-math
• Website: https://github.com/JowenDelaPena/date-math

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.JowenDelaPena/date-math.svg)](https://lookupd.com/servers/io.github.JowenDelaPena/date-math)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp