# 노동 업무 도구 (k-labor)

> 노동 업무 도구 (k-labor) is a free MCP server for legal and government. Korean payroll, leave, tax and labor-form tools: contracts, NHIS reports, calculators. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, Windows, macOS, Linux
- **Website:** https://yellowenvelope.kr/ai-tools
- **Repository:** https://github.com/seojaehong/labor-law-guide/tree/HEAD/tools/k-labor
- **MCP Registry name:** io.github.seojaehong/k-labor
- **Categories:** legal and government, finance and payments
- **Listing updated:** 2026-11-14

## About

Built by Yellow Envelope (yellowenvelope.kr), this package turns a Korean labor-compliance site into tools an assistant can call. The README says it can be run on your own PC through stdio, with tools grouped by area (nhis, popbill, contract, calc, leave, tax, duties, work-rules, nosa) so you switch on only what you need with the --groups option.

The tools cover finding the right National Health Insurance branch from an address or business number, building loss-of-eligibility and acquisition report PDFs, designing and checking employment contracts, and saving them as xlsx, hwpx or PDF. Calculators cover minimum wage, weekly holiday pay, severance, notice pay, leave pay, take-home pay, shutdown allowance, wage-delay interest, retirement tax and daily-worker withholding, with the legal basis cited. Optional Popbill tools send fax or SMS through your own account, only when you confirm.

Privacy is a design point. Names of people come from a local JSON file so resident numbers never enter the chat, and contract checks reject input that looks like a resident number. The site also lists a related Korean workers' compensation helper.

## Features

- **NHIS report forms:** Finds the branch and builds loss or acquisition report PDFs from a local people file.
- **Contract design and check:** Splits wages into items, reviews a written contract and saves xlsx, hwpx or PDF.
- **Wage calculators:** Minimum wage, severance, notice pay, shutdown allowance, holiday pay and more with legal basis.
- **Leave and tax:** Annual leave accrual, exit settlement, retirement tax and mid-year settlement.
- **Fax and SMS:** Popbill tools send only with confirm true, through your own account.
- **Switchable groups:** LLG_MCP_GROUPS or --groups enables just the bundles you need.

## Good for

- Find the insurance branch and fax number for a workplace
- Check whether a contract's wage items are in order
- Calculate severance and unused leave pay at resignation
- Test whether a 3.3% contractor looks like an employee

## Install

### Claude Code (Terminal)

```sh
claude mcp add k-labor --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' -- npx -y k-labor
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "k-labor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

- `find_branch`: Finds the NHIS branch and contacts for an address or business number.
- `make_form`: Builds NHIS loss or acquisition report PDFs.
- `popbill_status`: Checks the Popbill account and sender numbers.
- `send_fax`: Sends a fax through your Popbill account when confirmed.
- `fax_result`: Looks up a fax result.
- `send_sms`: Sends an SMS through your Popbill account when confirmed.
- `sms_result`: Looks up an SMS result.
- `design_contract_wage`: Designs the wage structure of an employment contract.
- `check_contract`: Checks an employment contract item by item.
- `make_contract_files`: Saves a contract as xlsx, hwpx and PDF locally.
- `check_min_wage`: Compares pay with the minimum wage.
- `calc_weekly_holiday_pay`: Calculates weekly holiday pay.
- `count_regular_workers`: Counts regular workers for the 5 and 10 employee thresholds.
- `calc_take_home_pay`: Calculates take-home pay.
- `calc_notice_pay`: Calculates dismissal notice pay.
- `calc_leave_pay`: Calculates annual leave pay.
- `calc_severance`: Calculates severance pay.
- `calc_holiday_pay`: Calculates pay for work on public holidays.
- `calc_pay_proration`: Prorates pay for partial months.
- `calc_shutdown_allowance`: Calculates business-shutdown allowance.
- `check_ordinary_wage`: Checks which items count as ordinary wage.
- `calc_wage_delay_interest`: Calculates delayed-wage interest.
- `check_contractor`: Checks whether a contractor resembles an employee.
- `check_monthly_pay`: Recalculates a month's pay against the amount received.
- `calc_annual_leave`: Calculates annual leave days.
- `settle_leave_on_exit`: Resettles leave on leaving.
- `calc_attendance_rate`: Calculates attendance rate for leave eligibility.
- `calc_retirement_tax`: Calculates retirement income tax.
- `calc_midyear_settlement`: Estimates mid-year leaver settlement.
- `calc_daily_worker_tax`: Calculates daily-worker withholding.
- `list_employer_duties`: Lists employer duties by worker count.

## FAQ

### Where does it run?

Locally over stdio with npx -y k-labor mcp; the site also offers some bundles as a remote URL.

### Does it send resident numbers to the AI?

The README and site say people lists are read from a local file and resident numbers are not sent to the chat.

### Do I need any keys?

Only for optional features: Popbill credentials for fax and SMS, and a law API ID for work-rules lookups.

### Can I enable only some tools?

Yes, by group names such as nhis, calc, contract.

### Is 노동 업무 도구 (k-labor) free?

Yes. 노동 업무 도구 (k-labor) is free to use.

### How do I add 노동 업무 도구 (k-labor) to Claude Code?

Run this command in your terminal: claude mcp add k-labor --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' -- npx -y k-labor

### What are the best alternatives to 노동 업무 도구 (k-labor)?

The closest alternatives to 노동 업무 도구 (k-labor) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/k-labor
