# Date Math

> Date Math is a freemium MCP server for developer tools. Deterministic date, time-zone, holiday and schedule calculations for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Repository:** https://github.com/jowendelapena/date-math
- **MCP Registry name:** io.github.JowenDelaPena/date-math
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://date-math.datemath.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/date-math
