hourledger-mcp

hourledger-mcp

An MCP server that calculates work hours, overtime, and gross pay — wrapping the same tested rules engine that powers HourLedger, a suite of free, no-sign-up work-hours calculators.

Tools

calculate_work_hours

Takes clock in/out entries (with unpaid breaks), an hourly rate, and a ruleset; returns the per-day and total regular / overtime / double-time split plus gross pay.

Supported rulesets, each covered by the automated test suite:

Ruleset	Rule
federal	1.5× past 40 h/week (FLSA)
california	1.5× past 8 h/day, 2× past 12 h/day, 7th-day rule, no pyramiding (Labor Code §510)
alaska	1.5× past 8 h/day or 40 h/week (AS 23.10.060)
colorado	1.5× past 12 h/day or 40 h/week (COMPS Order)
nevada	daily 8 h rule only below 1.5× minimum wage — applied automatically from the rate (NRS 608.018)

Handles overnight shifts, per-entry rounding policies (exact / 5 min / 15 min / 0.1 h), and configurable workweek start day.

time_and_a_half

Quick 1.5× rate and overtime-pay calculation from a rate and OT hours.

Setup

Claude Desktop / Claude Code

{
  "mcpServers": {
    "hourledger": {
      "command": "npx",
      "args": ["-y", "hourledger-mcp"]
    }
  }
}

Or with Claude Code: claude mcp add hourledger -- npx -y hourledger-mcp

Example

"How much do I make this week? I worked Monday to Thursday 7am–5pm at $19/hour in Nevada."

The model calls calculate_work_hours with the four 10-hour entries and gets back the correct Nevada answer ($19 ≥ $18 cutoff → weekly rule only → 40 regular hours, no OT), with day-by-day detail.

Interactive calculators

Prefer a UI? Every ruleset has a free, no-sign-up calculator at hourledger.com:

• Work hours & overtime · Overtime · Time and a half
• California · Alaska · Colorado · Nevada
• Embed a calculator on your own site

Disclaimer

General information, not legal or payroll advice. Exemptions and local rules vary — verify disputed pay with your state labor agency or a qualified professional.

Development

The pay-rules engine (src/engine.ts + its 27 tests) is mirrored from the HourLedger site project, where rule changes land first. npm test runs the full suite; prepublishOnly enforces tests + build before any publish.

License

MIT