Time Difference

Datetime REST API MCP

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.

This page documents the MCP tool findutils:time_difference. See the REST reference →

Use in the browser View as Markdown

Call it over MCP

Tool name findutils:time_difference · no API keys · 120 requests/min per IP

Claude Code

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

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "time_difference",
      "arguments": {
        "start": "22:00",
        "end": "06:00"
      }
    }
  }'

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)

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

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/time-difference/execute — no key, 60 requests/min.

Open the REST reference for Time Difference →

More Datetime tools

Age Calculate

Calculate age from a date of birth — years, months, days, plus totals in days, weeks, and months.

Career Experience Calculator

Calculate total professional experience across several jobs: total days, years/months/days, weeks, working days (5/7), working hours (8 per

Country Lookup

Return country facts — capital, currency (name, code, symbol), phone code, timezone, region, subregion, flag emoji, and languages — for coun

Cron Describe

Parse a 5-field cron expression (minute hour day-of-month month day-of-week) and produce a human-readable English description.

Cron To Systemd

Convert a 5-field cron expression into a systemd timer plus service unit and a Kubernetes CronJob YAML file.

Date Difference

Compute the difference between two dates in years/months/weeks/days/hours/minutes/seconds.

Date Difference Calculator

Calculate the difference between two dates in various units.

Pdf Delete Pages

Remove pages from a PDF and return the rest in their original order.