Hours Calculator MCP Server

Hours Calculator

Pure time arithmetic for duration between two clock times and paid work hours across one or more shifts (with breaks and optional daily grouping).

Capabilities

• Duration between times: Supply start and end in 24-hour HH:MM or HH:MM:SS. Get hours, minutes, seconds, and totals as decimal hours, decimal minutes, and whole seconds, plus a readable phrase. If end is earlier on the clock than start, either pass overnight=true (treats end as the next day) or the tool returns an error that points you to that flag.
• Work hours from shifts: Each shift has clock_in, clock_out, optional break_minutes (default 0), and optional date (YYYY-MM-DD). If clock_out is earlier on the clock than clock_in, the block is treated as an overnight shift. Returns a per-shift breakdown, total paid hours/minutes/seconds, regular_hours and overtime_hours against overtime_threshold (default 40 total hours for the whole request), and daily_totals_hours when dates are present.

Gotchas

• 24-hour times only; invalid strings are rejected with a short explanation.
• Overtime is computed from the sum of all shifts in the call versus overtime_threshold, not per calendar week unless your caller only sends one week’s shifts.
• break_minutes cannot exceed the gross span from clock-in to clock-out (before the break).