台灣勞健保勞退試算

supra126/taiwan-payroll

Wraps Taiwan's labor insurance, health insurance, pension, and occupational injury calculations into MCP tools that let Claude compute payroll deductions on the fly. Exposes `calculate_payroll` for monthly salary breakdowns across employee, employer, and government contributions, plus supplementary premium calculations for bonuses and other income types. Built on official 2024–2026 rate tables from Taiwan's Bureau of Labor Insurance and National Health Insurance Administration, with results validated bit-by-bit against government examples. Handles mid-month hire and termination prorations, generates NHI supplementary premium filing CSVs in Big5 encoding, and includes old-age pension estimators. Reach for this when you need Taiwan-specific payroll math in your AI workflows, either via the remote Cloudflare Workers endpoint or local stdio. Available as TypeScript and Python packages if you want the engine outside MCP.

tools: 9
transport: STDIO, HTTP
last updated: Jun 8, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://taiwan-payroll.simoko.workers.dev/mcp --name taiwan-payroll

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http taiwan-payroll https://taiwan-payroll.simoko.workers.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 9 tools

Verified live against the running server on Nov 6, 2026.

calculate_payroll計算台灣某月薪資的勞保（含就保）、健保、勞退、職災各方（員工/雇主/政府）負擔。支援不同身份別、眷屬、自提、部分工時。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。9 params

計算台灣某月薪資的勞保（含就保）、健保、勞退、職災各方（員工/雇主/政府）負擔。支援不同身份別、眷屬、自提、部分工時。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

dependentsinteger

健保眷屬人數（計費上限 3 口），預設 0。

employmentInsuranceboolean

是否參加就業保險（勞保費率 12.5% 或 11.5%），預設 true。一般移工/家事移工一律視為不參加。

identitystring

身份別（預設 category1）：category1=本國勞工或外籍配偶；migrantGeneral=一般移工（勞保僅普通事故 11.5%、無就保/勞退）；migrantDomestic=家事移工（僅健保＋職災，職災費率請以 occupationalRate 傳 0.0018）。不適用的險種回傳 0。one of category1 · migrantGeneral · migrantDomestic

monthlySalary*number

月薪資總額（經常性薪資），新臺幣元／月。

occupationalRatenumber

職災行業別費率，小數比例（如 0.0021 表 0.21%；家事移工 0.0018），範圍 [0, 0.02)。省略則用該年度平均費率。

partTimeboolean

是否為部分工時：true 時未達基本工資者勞保/健保對到官方低級距（職保仍歸第 1 級）。預設 false。

pensionSelfContributionnumber

勞工自願提繳率，小數（0~0.06，如 0.06 表 6%），預設 0。

roundingstring

進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。one of round · ceil · aggregate-then-round

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

calculate_supplementary_premium計算二代健保補充保費（費率 2.11%）。bonus 課徵年度累計超過當月投保額 4 倍部分；其餘五類單次達門檻全額課（單次上限 1,000 萬）。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。6 params

計算二代健保補充保費（費率 2.11%）。bonus 課徵年度累計超過當月投保額 4 倍部分；其餘五類單次達門檻全額課（單次上限 1,000 萬）。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

amount*number

單次給付金額，新臺幣元。

monthlyInsuredSalarynumber

（僅 bonus 必填）給付當月之投保金額，新臺幣元／月；門檻為其 4 倍。

roundingstring

進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。one of round · ceil · aggregate-then-round

type*string

所得類別：bonus=高額獎金、parttime=兼職薪資、professional=執行業務、dividend=股利、interest=利息、rent=租金。one of bonus · parttime · professional · dividend · interest · rent

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

ytdBonusnumber

（僅 bonus）本次給付前、同雇主同年度已累計之獎金，預設 0。

calculate_employer_supplementary_premium計算雇主端二代健保補充保費（費率 2.11%）：(每月支付薪資總額 − 受僱者當月健保投保金額總額) × 費率，無上限。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。4 params

計算雇主端二代健保補充保費（費率 2.11%）：(每月支付薪資總額 − 受僱者當月健保投保金額總額) × 費率，無上限。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

monthlyInsuredTotal*number

受僱者當月健保投保金額總額 B，新臺幣元（全體受僱者投保金額合計）。

monthlyPaidTotal*number

每月支付薪資所得總額 A，新臺幣元（含薪資、獎金、兼職、車馬費、承攬等）。

roundingstring

進位策略：round=四捨五入（預設）、ceil=無條件進位、aggregate-then-round=合計後分配（政府方吸收進位差）。one of round · ceil · aggregate-then-round

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

calculate_income_tax_withholding計算薪資所得扣繳稅額：居住者固定月薪(公式法)、非每月給付獎金(5%，未達起扣標準免扣)、非居住者(18%；月薪≤1.5倍基本工資為6%)。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。5 params

計算薪資所得扣繳稅額：居住者固定月薪(公式法)、非每月給付獎金(5%，未達起扣標準免扣)、非居住者(18%；月薪≤1.5倍基本工資為6%)。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

amountnumber

該筆給付金額，新臺幣元（僅 residentBonus）。

dependentsinteger

配偶及受扶養親屬人數（僅 resident），預設 0。

monthlySalarynumber

月薪資，新臺幣元（resident／nonResident 用）。

type*string

扣繳類型：resident=居住者固定月薪(公式法)、residentBonus=居住者非每月給付(獎金)5%、nonResident=非居住者18%/6%。one of resident · residentBonus · nonResident

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

calculate_old_age_pension依勞保老年年金法定公式（擇優兩式、提前/延後增減給每年 ±4%，上限 ±5 年（±20%））試算月領金額；年資未滿 15 年不符年金請領資格。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。5 params

依勞保老年年金法定公式（擇優兩式、提前/延後增減給每年 ±4%，上限 ±5 年（±20%））試算月領金額；年資未滿 15 年不符年金請領資格。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

avgInsuredSalary*number

平均月投保薪資（最高 60 個月平均），新臺幣元。

claimOffsetMonthsinteger

提前(負)/延後(正)請領月數，相對法定請領年齡；每年 ±4%，上限 ±5 年（±20%）。預設 0。

monthsinteger

保險年資：月（0–11），預設 0。

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

years*integer

保險年資：年。

calculate_old_age_lump_sum依勞保老年一次金法定公式（平均月投保薪資 × 給付月數；年資每滿 1 年給 1 個月、逾 60 歲後之年資最多計入 5 年）試算給付金額。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。5 params

依勞保老年一次金法定公式（平均月投保薪資 × 給付月數；年資每滿 1 年給 1 個月、逾 60 歲後之年資最多計入 5 年）試算給付金額。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

avgInsuredSalary*number

平均月投保薪資（最高 60 個月平均），新臺幣元。

monthsinteger

保險年資：月（0–11），預設 0。

postSixtyMonthsinteger

逾 60 歲以後之保險年資（月），最多計入 5 年（60 個月），超過部分不計。不得超過總保險月數。預設 0。

yearinteger

年度（西元，如 2026）。省略則使用最新可用年度；可先用 list_years 查可用年度。

years*integer

保險年資：年。

calculate_old_age_single_payment依勞保一次請領老年給付法定公式（基數制：前 15 年每年 1 個基數、第 16 年起每年 2 個基數、60 歲前最高 45 個基數、逾 60 歲後年資每年 2 個基數最多計 5 年、合併最高 50 個基數）試算給付金額。適用 98 年前已有保險年資者。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。6 params

依勞保一次請領老年給付法定公式（基數制：前 15 年每年 1 個基數、第 16 年起每年 2 個基數、60 歲前最高 45 個基數、逾 60 歲後年資每年 2 個基數最多計 5 年、合併最高 50 個基數）試算給付金額。適用 98 年前已有保險年資者。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。

Parameters* required

avgInsuredSalary*number

平均月投保薪資（採退保前 3 年內最高 36 個月平均），新臺幣元。

postSixtyMonthsinteger

逾 60 歲以後之保險年資：月（0–11），預設 0。

postSixtyYearsinteger

逾 60 歲以後之保險年資：年。逾 60 歲後最多計入 5 年，超過部分不計。預設 0。

preSixtyMonthsinteger

60 歲（含）以前之保險年資：月（0–11），預設 0。

preSixtyYears*integer

60 歲（含）以前之保險年資：年。

yearinteger