# Time Difference — REST API endpoint `time-difference`

Work out how long there is between two times of day, with no dates involved. Handles a shift that crosses midnight — 22:00 to 06:00 is eight hours, not minus sixteen — and can subtract an unpaid break. Accepts 24-hour times and am/pm, and returns the duration both as hours and minutes and as decimal hours for invoicing.

- Category: datetime
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/time-difference/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/time-difference/
- Same tool on the other surface: https://findutils.com/mcp/time-difference/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/time-difference/execute \
  -H "Content-Type: application/json" \
  -d '{
    "start": "22:00",
    "end": "06:00"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/time-difference
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `start` | string | yes | Start time: "09:00", "9:00:30" or "9:00 am". |
| `end` | string | yes | End time, same formats. "24:00" means the end of the day. |
| `overnight` | string (auto \| always \| never) | no | auto wraps past midnight only when the end is not after the start. always puts the end on the NEXT day, so 09:00 to 17:00 becomes 32 hours. never refuses to wrap and errors instead. Default: auto. Default: `"auto"`. |
| `break_minutes` | number | no | Unpaid break to subtract, in minutes. Default: 0. Default: `0`. |

Example arguments (verified):

```json
{
  "start": "22:00",
  "end": "06:00"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:time_difference`. Full MCP reference: https://findutils.com/mcp/time-difference/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt