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:

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