노동 업무 도구 (k-labor)
Korean payroll, leave, tax and labor-form tools: contracts, NHIS reports, calculators
- Pricing
- Free
- Platforms
- CLI, self-hosted, Windows
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 3 days ago
About 노동 업무 도구 (k-labor)
노동 업무 도구 (k-labor) is a free MCP server for legal and government. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add k-labor --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' -- npx -y k-laborAdd to claude_desktop_config.json
{
"mcpServers": {
"k-labor": {
"command": "npx",
"args": [
"-y",
"k-labor"
],
"env": {
"POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"k-labor": {
"command": "npx",
"args": [
"-y",
"k-labor"
],
"env": {
"POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"k-labor": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"k-labor"
],
"env": {
"POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"k-labor": {
"command": "npx",
"args": [
"-y",
"k-labor"
],
"env": {
"POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"k-labor": {
"command": "npx",
"args": [
"-y",
"k-labor"
],
"env": {
"POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
}
}
}
}Configuration
LLG_MCP_GROUPS켤 묶음(쉼표 구분: nhis, popbill, contract, calc, leave, tax, duties, work-rules, nosa). 비우면 전부LAW_OC법제처 국가법령정보 Open API 이용자 ID(OC). 없으면 work-rules 는 묶은 자료로만 답합니다POPBILL_LINK_ID팩스·문자용 본인 팝빌 링크아이디POPBILL_SECRET_KEY팩스·문자용 본인 팝빌 비밀키POPBILL_CORP_NUM팝빌에 가입한 사업자등록번호(숫자 10자리)POPBILL_FAX_SENDER팝빌에 등록한 팩스 발신번호POPBILL_SMS_SENDER팝빌에 등록한 문자 발신번호POPBILL_IS_TEST기본 true(팝빌 테스트환경). 운영환경은 false
Tools this server provides (31)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Free
No account or token required for the tools per the site; Popbill messaging uses your own account
Prices change. Check yellowenvelope.kr before you buy.
노동 업무 도구 (k-labor) 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 to 노동 업무 도구 (k-labor)

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments