Date Math v1.7.0
Date Math / Tools / find_free_slots

Find free meeting 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 lists slots of the requested length. Up to 10 people, 14 days, optional buffer between meetings. Use for scheduling across calendars and time zones.

MCP tool find_free_slotsHTTP POST /v1/free_slots25 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.

find_free_slots
result
{
  "timezone": "Asia/Manila",
  "range": {
    "start": "2026-11-10T00:00:00+08:00",
    "end": "2026-11-12T00:00:00+08:00"
  },
  "duration_minutes": 30,
  "free_windows": [
    {
      "start": "2026-11-10T16:00:00+08:00",
      "end": "2026-11-10T17:00:00+08:00",
      "start_utc": "2026-11-10T08:00:00Z",
      "end_utc": "2026-11-10T09:00:00Z",
      "minutes": 60
    }
  ],
  "count": 3,
  "slots": [
    {
      "start_utc": "2026-11-10T08:00:00Z",
      "end_utc": "2026-11-10T08:30:00Z",
      "local": [
        {
          "timezone": "Asia/Manila",
          "start": "2026-11-10T16:00:00+08:00",
          "end": "2026-11-10T16:30:00+08:00"
        }
      ]
    }
  ]
}

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 find_free_slots 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/free_slots \
  -H "Content-Type: application/json" \
  -d '{"participants":[{"timezone":"Asia/Manila","busy":[{"start":"2026-11-10T01:00:00Z","end":"2026-11-10T02:00:00Z"}]},{"timezone":"Europe/London","work_start":"08:00","work_end":"16:00"}],"from":"2026-11-10","days":2,"duration_minutes":30,"max_slots":3}'

Full schema: OpenAPI · llms.txt