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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wudongjie
• Source: wudongjie/hourledger-mcp
• License: MIT
• Homepage: https://hourledger.com/mcp

Install and usage instructions live in the source repository linked above.