Korea Business Calendar

io.github.groove79Published by GitHub account groove79v0.1.1Updated Oct 29, 2026

Korean tax/payroll deadlines, public holidays, business-day math. No keys. 세무 일정·영업일 MCP.

VerifiedSTDIODesktop onlyProductivity & WorkflowFinance

Overview

AI-generated overview

Offline MCP server for Korean business dates: public holidays, business-day math, and tax/payroll filing deadlines.

What you can do
  • List Korean public holidays for a year, including substitute holidays and election days
  • Check whether a date is a business day and get the next and previous business days
  • Add or subtract business days, or count business days between two dates
  • Return tax and payroll filing deadlines for a business profile, filtered by month or upcoming days
  • Explain a single tax or payroll obligation by id: what it is, who files, and when
When to use it
Useful when an assistant helps with Korean scheduling: delivery promises, shipping ETAs, meeting dates, payroll calendars, or answering what a Korean business must file this month.
Requirements
Runs locally over stdio, typically launched with npx from the npm package. No API keys, accounts, or network access are needed; lunar holiday dates are built in for 2025–2028.
Before you install
Deadlines are a scheduling aid, not tax advice; the README says to confirm with 홈택스 notices. Special regimes such as 성실신고확인, 반기납부 and 수정신고 are noted but not computed, and lunar holidays outside 2025–2028 must be supplied by the caller.

Installation

In SourceWeft

  1. Open Korea Business Calendar in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@appmonster/mcp-kr-biz-calendar

MCP server for Korean business dates — no keys, no network. An agent gets:

  • Public holidays with computed 대체공휴일 and election days (2025–2028 lunar table built in)
  • Business-day math: "3 영업일 후", count business days between dates, next/previous business day
  • Tax & payroll calendar per business profile: 부가세 확정·예정, 종합소득세, 법인세, 원천세·4대보험 매월 10일, 지급명세서, 연말정산 — each moved to the next business day when it lands on a holiday (국세기본법 §5)

한국 사업자용 세무·노무 일정과 영업일 계산. 키 없이 바로 동작.

Tools

ToolWhat it does
kr_list_holidays연도별 공휴일 (대체공휴일·선거일 포함)
kr_is_business_day영업일 여부 + 다음/이전 영업일
kr_add_business_days영업일 더하기/빼기, 두 날짜 사이 영업일 수
kr_tax_calendar사업자 유형(개인·간이·법인·면세)·고용 여부별 신고 일정, 월/다가오는 N일 필터
kr_tax_rule일정 항목 설명 (무엇을, 누가, 언제)

Setup

json
{ "mcpServers": { "kr-biz-calendar": { "command": "npx", "args": ["-y", "@appmonster/mcp-kr-biz-calendar"] } } }

Examples

  • "이번 달 우리 회사가 신고할 거 뭐 있어?" → kr_tax_calendar {entity: "corporation", employees: true, month: 10}
  • "오늘 발송하면 영업일 3일 뒤 도착 — 언제?" → kr_add_business_days {days: 3}
  • "1/25가 일요일인데 부가세 언제까지?" → calendar already returns 2026-01-26 (shifted)

Coverage & accuracy

  • Lunar holidays (설날·추석·부처님오신날) are tabled for 2025–2028. For other years pass extraHolidays from the public-data server's kr_holidays (official KASI data); the tools say so in note.
  • Substitute-holiday rules follow the 2023 amendment (all holidays except 신정·현충일; overlaps count).
  • Deadlines encode standard rules for a 12월 결산 법인 and calendar-year individuals. Special regimes (성실신고확인, 반기납부, 수정신고) are noted in what, not computed. Always confirm with 홈택스 notices; this is a scheduling aid, not tax advice.

Development

bash
pnpm --filter @appmonster/mcp-kr-biz-calendar test

Source: packages/kr-biz-calendar/README.md at commit 2f1998f

Tools

5

kr_list_holidays

List Korean public holidays for a year including computed 대체공휴일 (substitute holidays) and election days. Offline; lunar dates tabled for 2025–2028. 연도별 공휴일(대체공휴일 포함)을 반환합니다. Use for scheduling, delivery promises, payroll calendars. Needs year.

ParametersyearrequiredextraHolidays

kr_is_business_day

Tell whether a date is a Korean business day (평일, not a public holiday), and give the next and previous business days. 해당 날짜가 영업일인지 확인합니다. Use before promising a delivery/meeting date. Needs a date (default today, KST).

ParametersdateextraHolidays

kr_add_business_days

Add (or subtract) N Korean business days to a date, skipping weekends and public holidays — e.g. '3 business days after today' for shipping ETAs, or count business days between two dates. 영업일 기준으로 날짜를 더하거나 두 날짜 사이 영업일 수를 셉니다. Use for 납기·배송·결제 기한 계산. Needs from (default today) and either days or to.

ParameterstodaysfromextraHolidays

kr_tax_calendar

Korean tax & payroll filing deadlines for a business profile: VAT (부가세 확정·예정), income/corporate tax, withholding (원천세) and 4대보험 monthly, 지급명세서, 연말정산 — each shifted to the next business day when it falls on a holiday. Filter by month or 'upcoming'. 사업자 유형별 세무·노무 신고 일정을 반환합니다. Use for '이번 달 신고할 것', reminders, cash planning. Needs entity (individual/simplified/corporation/taxfree); employees true if you pay anyone.

ParametersyearmonthentityemployeesupcomingDaysextraHolidayswithholdingHalfYear

kr_tax_rule

Explain one recurring Korean tax/payroll obligation by id (from kr_tax_calendar): what it is, who files, when, and the base dates. 세무 일정 항목의 설명을 반환합니다. Use when the agent needs to tell the owner what a deadline means. Needs id.

Parametersid

Version history

2
  1. v0.1.1LatestOct 23, 2026
  2. v0.1.0Oct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts