HourLedger MCP Server

hourledger-mcp gives AI assistants like Claude the same tested pay-rules engine that powers this site. Ask your assistant a messy real-world question — “I worked Monday to Thursday 7am–5pm at $19/hour in Nevada, what's my gross pay?” — and it calls the calculator instead of doing arithmetic from memory.

MCP (Model Context Protocol) is the open standard for connecting tools to AI assistants. The package is free, open to use, and published on npm.

The 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. Supports federal (40 h/week), California (daily OT, double time, 7th-day rule), Alaska (8 h/day), Colorado (12 h/day), and Nevada (rate-dependent daily rule, applied automatically). Handles overnight shifts, rounding policies, and workweek start day. Every rule is covered by the automated test suite.

time_and_a_half

An hourly rate and overtime hours — returns the 1.5× rate and total overtime pay. The instant version of the time and a half calculator.

Install

Requires Node.js. No API key, no account — the server runs locally and your data never leaves your machine.

Claude Code

claude mcp add hourledger -- npx -y hourledger-mcp

Claude Desktop

Settings → Developer → Edit Config, then add to claude_desktop_config.json and restart the app:

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

Cursor, Windsurf & other MCP clients

Any client that supports stdio MCP servers works with the same command:

npx -y hourledger-mcp

Try it

Once installed, paste one of these into your assistant:

“What's time and a half of $24/hour, and what would 6 overtime hours pay?”
“I work in Nevada, Monday through Thursday 7am to 5pm. Compare my weekly pay at $15/hour vs $20/hour.” — watch the daily overtime appear below Nevada's $18 cutoff and disappear above it.
“I'm in California at $22/hour. Monday I worked 6am to 7pm, Tuesday 10pm to 6am overnight. Break down my regular, overtime, and double time pay.”

Prefer a UI?

Every ruleset has a free, no-sign-up calculator on this site — start at the work hours & overtime calculator — or embed one on your own site. Found a result you believe is wrong? Report it — correction reports are the project's highest-priority work.

Built by an independent developer. HourLedger is built in public by a solo developer: every pay rule ships with automated tests, and your entries never leave your browser. Read the story, get in touch, or embed this calculator on your own site for free.