HourLedger — Work Hours & Overtime Calculator

Created By

wudongjie8 days ago

Calculate work hours, overtime, and gross pay with tested rulesets for US federal, California, Alaska, Colorado, and Nevada law. Handles overnight shifts, rounding policies, and workweek start. Local, no API key, no data leaves your machine.

# payroll

# overtime

Overview Content Tools Comments

Overview

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.

Server Config

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

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

WindsurfThe new purpose-built IDE to harness magic

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

DeepChatYour AI Partner on Desktop

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

Serper MCP ServerA Serper MCP Server

Playwright McpPlaywright MCP server

ChatWiseThe second fastest AI chatbot™

Tavily Mcp

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

RedisA Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.

CursorThe AI Code Editor

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Amap Maps高德地图官方 MCP Server

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code