Skip to content
MCP server

Date Math

Deterministic date, time-zone, holiday and schedule calculations for AI agents

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
1.8.0
Listing updated
today

Similar MCP servers

About Date Math

Date Math is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

Models often get business-day counts, daylight-saving shifts and holiday calendars wrong. This server hands those calculations to code, offering 23 paid-per-call tools over MCP plus a free current-time tool.

Coverage goes beyond basic date arithmetic: public holidays for 207 countries from 2000 to 2050, a database of over 7,000 cities, market calendars for NYSE/Nasdaq, London and Tokyo, SLA clocks that pause outside working hours, Schengen-style 90/180 stay limits, subscription renewal dates and time buckets that handle 23- and 25-hour days.

The first 25 tool calls each day are free with no signup or key. After that each call costs $0.001 in USDC on Base through x402, paid automatically when a wallet key is set for the local npm package. It runs as a hosted Streamable HTTP endpoint or locally over stdio.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://date-math.datemath.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "date-math": {
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "date-math": {
      "type": "http",
      "url": "https://date-math.datemath.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • DATE_MATH_PRIVATE_KEYOptional. 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).

Tools this server provides (24)

Taken from the project documentation; the running server may differ.

date_diff
Days, weeks, months and business days between two dates.
date_add
Adds days, weeks, months or business days to a date.
timezone_convert
Converts a time between IANA time zones.
date_info
Weekday, ISO week, quarter, day of year, leap year.
public_holidays
Public holidays for 207 countries.
working_hours_overlap
Finds overlapping working hours across zones.
cron_schedule
Explains a cron expression and lists next runs.
parse_date_text
Turns date phrases into ISO datetimes.
city_time
City name to time zone and local time.
recurring_dates
Expands an iCal RRULE into dates.
business_hours_deadline
SLA deadline N working hours ahead.
business_day
Checks whether a date is a business day.
pay_dates
Payroll and billing dates moved off weekends and holidays.
stay_calculator
Schengen-style 90/180 stay limits.
timestamp_normalize
Converts mixed timestamps to UTC.
dst_check
Daylight-saving changes and local time validity.
sla_countdown
Live SLA clock for support tickets.
find_free_slots
Meeting slots when everyone is free.
subscription_dates
Billing period, renewal and cancel-by dates.
market_calendar
Market sessions, holidays and settlement dates.
date_range
Phrases like last month to exact start and end.
business_day_schedule
Holiday-aware job schedules.
time_buckets
Time-series buckets that are DST-aware.
current_time
Current time in up to 10 zones, free.

What it does

Business-day math
Adds, subtracts and counts business days, skipping weekends and country holidays.
Time-zone conversion
Converts between IANA zones and handles daylight-saving gaps and repeats.
Schedules and recurrence
Explains cron, expands RRULEs and builds holiday-aware job schedules.
SLA and business hours
Computes deadlines and live countdowns that pause outside working time.
Market calendars
Reports open status, sessions, holidays and settlement dates for three exchanges.
Natural-language dates
Turns phrases like next Friday at 3pm or 2026-Q3 into exact ranges.
Timestamp normalising
Converts up to 100 mixed formats to UTC and flags ambiguous ones.

Good for

  • Compute a support ticket's SLA deadline in working hours
  • Find meeting slots that fit people in different time zones
  • Check how many days are left in a 90/180 travel stay
  • Schedule payroll dates that avoid weekends and holidays
  • Normalise a column of mixed timestamps before analysis

Pricing

Freemium

25 free calls a day, then $0.001 per call in USDC on Base

Date Math FAQ

Is it free?

25 tool calls per day are free with no key; beyond that each call is $0.001 in USDC on Base.

Do I need an account?

No. The README says there is no signup and no API key.

How do I install it?

Use the hosted URL as a remote MCP server, or run the npm package date-math-mcp over stdio.

How many holiday calendars?

Public holidays for 207 countries, 2000 to 2050.

Is Date Math free?

Date Math has a free plan, with paid plans for more usage or features.

How do I add Date Math to Claude Code?

Run this command in your terminal: claude mcp add --transport http date-math https://date-math.datemath.workers.dev/mcp

What are the best alternatives to Date Math?

The closest alternatives to Date Math are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers