# Hourledger Mcp

> MCP server for work hours & overtime pay — federal, CA, AK, CO, NV rules, fully tested. Powered by hourledger.com

- **Type:** MCP server
- **Install:** `agentstack add mcp-wudongjie-hourledger-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [wudongjie](https://agentstack.voostack.com/s/wudongjie)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [wudongjie](https://github.com/wudongjie)
- **Source:** https://github.com/wudongjie/hourledger-mcp
- **Website:** https://hourledger.com/mcp

## Install

```sh
agentstack add mcp-wudongjie-hourledger-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hourledger-mcp

An [MCP](https://modelcontextprotocol.io) server that calculates **work hours, overtime, and gross pay** — wrapping the same tested rules engine that powers [HourLedger](https://hourledger.com), 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](https://www.dol.gov/agencies/whd/overtime)) |
| `california` | 1.5× past 8 h/day, 2× past 12 h/day, 7th-day rule, no pyramiding ([Labor Code §510](https://leginfo.legislature.ca.gov/faces/codes_displaySection.xhtml?lawCode=LAB&sectionNum=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

```json
{
  "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](https://hourledger.com)**:

- [Work hours & overtime](https://hourledger.com) · [Overtime](https://hourledger.com/overtime-calculator) · [Time and a half](https://hourledger.com/time-and-a-half-calculator)
- [California](https://hourledger.com/california-overtime-calculator) · [Alaska](https://hourledger.com/alaska-overtime-calculator) · [Colorado](https://hourledger.com/colorado-overtime-calculator) · [Nevada](https://hourledger.com/nevada-overtime-calculator)
- [Embed a calculator on your own site](https://hourledger.com/embed)

## 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](https://github.com/wudongjie)
- **Source:** [wudongjie/hourledger-mcp](https://github.com/wudongjie/hourledger-mcp)
- **License:** MIT
- **Homepage:** https://hourledger.com/mcp

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-wudongjie-hourledger-mcp
- Seller: https://agentstack.voostack.com/s/wudongjie
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.