HourLedger — Work Hours & Overtime Calculator

by wudongjie

311 downloads
Not rated
GitHub

About

Work hours, overtime, and gross pay calculation with tested rulesets for US federal, California, Alaska, Colorado, and Nevada law.

Details

Author
wudongjie
Downloads
311
Categories
Finance, Security, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name HourLedger — Work Hours & Overtime Calculator
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the hourledger-mcp package (available on npm and the official MCP registry) and configure your MCP client to use its two tools: calculate_work_hours for full shift breakdowns and `time_and_a

calculate_work_hours

Calculate regular/overtime/double-time hours and gross pay from clock in/out entries. Rulesets: federal (40h/week), california (8h/day 1.5x, 12h/day 2x, 7th-day rule), alaska (8h/day or 40h/week), colorado (12h/day or 40h/week), nevada (8h/day below $18/h, else weekly). Full calculators at https://hourledger.com

time_and_a_half

Calculate a time-and-a-half (1.5x) overtime rate and total overtime pay from an hourly rate and overtime hours. Interactive version: https://hourledger.com/time-and-a-half-calculator

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hourledger \u2014 work hours & overtime calculator": {
            "hourledger": {
                "command": "npx",
                "args": [
                    "-y",
                    "hourledger-mcp"
                ]
            }
        }
    }
}

McpServers

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

AnMCPserver that calculateswork hours, overtime, and gross pay— wrapping the same tested rules engine that powersHourLedger, a suite of free, no-sign-up work-hours calculators.

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.

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

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

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

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

The model callscalculate_work_hourswith 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.

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

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

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

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

Tamper-evident audit logging for AI decisions. Three tools (record_decision, verify_decision, list_decisions) write to a regulator-grade ledger built on AWS S3 Object Lock with 7-year retention. Designed for EU AI Act Article 12 and FCA SS1/23 evidence requirements. Try zero-config: npx audit-ledger-mcp boots in sandbox mode against a public hosted tenant.

UK mortgage calculators from Fox Davidson, FCA-authorised brokers: stamp duty (SDLT/LBTT/LTT) and FCA MCOB 3A high net worth qualification.

185 agent-payable C-suite intelligence tools — competitive intel, SEC filings, sanctions, KYC, clinical evidence, ESG. x402 USDC/EURC. 100 free calls/mo.

An MCP server that gives AI assistants and agents access to global tax compliance knowledge and tools — built and maintained by https://goodvat.com

Imperio — Italian Tax & Compliance Tools

Italian tax & compliance tools (Codice Fiscale, P.IVA, IBAN, ATECO, IVA, IMU, forfettario, F24, FatturaPA, Intrastat, NIS2 scope under Italian Legislative Decree 138/2024) plus anti-fraud payee verification, citing the article for every step. Deterministic official algorithms — no LLM inference.

Global e-invoicing compliance: Factur-X, Peppol UBL, CII & more

Hosted MCP server for global e-invoice compliance: create, validate, embed, extract & convert Factur-X, Peppol UBL, CII & more

Forensic FX audit MCP. Detects hidden bank markups on cross-border payments. FINTRAC MSB registered.

Company, KYB, VAT, sanctions, LEI and address data for 15 EU countries (DK, NO, SE, FI, IE, UK, FR, DE, CZ, PL, LV, EE, NL, BE, LU). Free tier 100 lookups/day at addonnordic.com.

Look up companies, board members, and business roles across Norway, Denmark, Finland, and Sweden's official business registries.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.