Meeting Planner API

Find the hours on a date when working hours overlap across 2 to 6 time zones (DST-aware), with each overlap in UTC and every zone's local time.

POST /api/v1/tools/meeting-plannerMCP meeting_plannerTime & Date

Find meeting times that suit everyone: compare up to six time zones hour by hour on any date, see working hours and the overlap, and share the plan by link.

Input

Send these as a JSON object. Unknown fields are rejected.

date: The meeting date as YYYY-MM-DD; the day runs midnight to midnight in the first zone. (string, up to 10 characters, required)
zones: Comma-separated IANA time zones, 2 to 6, e.g. "America/New_York,Europe/London,Asia/Kolkata". (string, up to 500 characters, required)
workStart: Start of working hours in every zone, HH:MM 24-hour. (string, up to 5 characters, default "09:00")
workEnd: End of working hours in every zone, HH:MM 24-hour (24:00 allowed). (string, up to 5 characters, default "17:00")
includeGrid: Also return the full hour-by-hour grid of local times for each zone. (boolean, default false)

Try it in the browser JSON Schema Get an API key

curl https://pithlab.com/api/v1/tools/meeting-planner \n  -H "Authorization: Bearer $PITHLAB_KEY" \n  -H "Content-Type: application/json" \n  -d '{"date":"2026-10-20","zones":"America/New_York,Europe/London","workStart":"09:00","workEnd":"17:00"}'

Example response

{
  "ok": true,
  "result": {
    "overlapHours": 3,
    "overlaps": [
      {
        "startUtc": "2026-10-20T13:00:00.000Z",
        "endUtc": "2026-10-20T16:00:00.000Z",
        "hours": 3,
        "utc": "13:00–16:00 UTC",
        "local": [
          {
            "zone": "America/New_York",
            "range": "09:00–12:00"
          },
          {
            "zone": "Europe/London",
            "range": "14:00–17:00"
          }
        ]
      }
    ],
    "summary": "3 hours of overlap: 13:00–16:00 UTC (America/New_York 09:00–12:00, Europe/London 14:00–17:00)"
  }
}