Date Math / Tools / parse_date_text

Parse natural-language dates

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, relative to a reference time and time zone. Use before acting on any date a user typed.

MCP tool parse_date_textHTTP POST /v1/parse25 free calls a day, then $0.001

Try it

Runs the real tool over MCP. Edit the arguments and run. Uses your daily free calls.

parse_date_text

result

{
  "text": "next friday at 3pm",
  "timezone": "Asia/Manila",
  "reference": "2026-11-07T14:00:00+08:00",
  "count": 1,
  "results": [
    {
      "matched": "next friday at 3pm",
      "index": 0,
      "start": {
        "utc": "2026-11-13T07:00:00Z",
        "local": "2026-11-13T15:00:00+08:00",
        "date": "2026-11-13",
        "weekday": "Friday"
      },
      "certain": [
        "weekday"
      ]
    }
  ]
}

The result shown before you run is a saved example response.

Use it from your agent

Add the MCP server once and your agent can call parse_date_text and the other 19 tools.

Claude Code

One command in your terminal.

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

Any MCP client

Claude Desktop, Cursor, VS Code, Windsurf.

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

HTTP + x402

POST JSON; pay the 402 with any x402 client.

curl -X POST https://date-math.datemath.workers.dev/v1/parse \
  -H "Content-Type: application/json" \
  -d '{"text":"next friday at 3pm","timezone":"Asia/Manila","reference":"2026-11-07T14:00:00+08:00"}'

Full schema: OpenAPI · llms.txt