What it does
hourledger-mcp gives AI assistants the same tested pay-rules engine that powers hourledger.com. Ask a messy real-world question — "I worked Monday to Thursday 7am–5pm at $19/hour in Nevada, what's my gross pay?" — and the assistant calls the calculator instead of doing payroll arithmetic from memory.
Tools
calculate_work_hours
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.
| 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 |
alaska | 1.5× past 8 h/day or 40 h/week |
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 (exact / 5 min / 15 min / 0.1 h), and configurable workweek start day. Every pay rule is covered by the automated test suite (27 tests in the repo).
time_and_a_half
An hourly rate and overtime hours — returns the 1.5× rate and total overtime pay.
Try it
- "What's time and a half of $24/hour, and what would 6 overtime hours pay?"
- "I work in Nevada, Mon–Thu 7am–5pm. Compare my weekly pay at $15/hour vs $20/hour." — watch daily overtime appear below Nevada's $18 cutoff and disappear above it.
- "I'm in California at $22/hour. Monday I worked 6am–7pm, Tuesday 10pm–6am overnight. Break down my regular, overtime, and double time pay."
Privacy
Runs locally over stdio. No API key, no account, no data leaves your machine.
Links
- Website & docs: https://hourledger.com/mcp
- npm: https://www.npmjs.com/package/hourledger-mcp
- Official MCP registry:
io.github.wudongjie/hourledger-mcp - Free web calculators: https://hourledger.com
Server Config
{
"mcpServers": {
"hourledger": {
"command": "npx",
"args": [
"-y",
"hourledger-mcp"
]
}
}
}