Korean business days and legal deadlines in Claude and Cursor

Updated 2026-11-15. Every result below is the server's actual response.

If you ask a model "is May 1, 2026 a business day in Korea?" it has to rely on what it learned. Korea added two public holidays in 2026: Labor Day (May 1) and Constitution Day (July 17). Substitute holidays and election days are announced year by year. A model trained before those decisions may count them as working days, and a deadline that crosses one of those days moves.

This server has the official calendar and the counting rules. The model calls it and writes the answer from the result.

Set it up

Claude Code

claude mcp add --transport http korea-tools "https://mcp.thequokkacompany.com/korea?ref=guide"

Claude.ai or Claude Desktop: Settings → Connectors → Add custom connector, paste https://mcp.thequokkacompany.com/korea?ref=guide.

Cursor (.cursor/mcp.json)

{ "mcpServers": { "korea-tools": { "type": "http", "url": "https://mcp.thequokkacompany.com/korea?ref=guide" } } }

?ref=guide only tells us which page you came from. The server works the same without it. No account or key for up to 200 calls a day.

1. Is it a business day?

Prompt: Is 2026-05-01 a business day in Korea? If not, what is the next one?

kr_business_day {"date": "2026-05-01"}
→ is_business_day: false, holidays: ["노동절"], next_business_day: "2026-05-04"

May 1 is a Friday. The next business day is Monday, May 4.

2. A deadline in business days

Prompt: Payment is due 3 business days after 2026-09-23. Which date?

kr_add_business_days {"start": "2026-09-23", "days": 3}
→ result: "2026-09-30"
  skipped: 09-24 추석 전날, 09-25 추석, 09-26 추석 다음 날, 09-27 Sunday

Chuseok takes three days that year, so a "3 business days" deadline lands a full week later.

Across New Year it looks like this: 5 business days after 2026-12-24 is 2027-01-04, skipping Christmas, two weekends and January 1.

3. A legal deadline under the Civil Act

When a law or contract says "within 14 days" or "within 1 month" and gives no other rule, Korea's Civil Act (articles 155-161) applies. The first day is not counted. Months follow the calendar, and the period ends the day before the same date. If that date does not exist, the period ends on the last day of the month. If the last day is a Saturday or a public holiday, the deadline moves to the next day.

Prompt: A notice arrived on 2026-04-17. When does a 14-day period end?

kr_legal_deadline {"event_date": "2026-04-17", "amount": 14, "unit": "day"}
→ nominal_last_day: "2026-05-01", deadline: "2026-05-04"
  extended over: 05-01 노동절, 05-02 Saturday, 05-03 Sunday

Prompt: One month from 2026-01-30?

kr_legal_deadline {"event_date": "2026-01-30", "amount": 1, "unit": "month"}
→ nominal_last_day: "2026-02-28", deadline: "2026-03-03"
  extended over: 02-28 Saturday, 03-01 3ㆍ1절, 03-02 대체공휴일(3ㆍ1절)

Counting starts on January 31. February has no 31st, so the nominal last day is February 28. That is a Saturday, March 1 is Independence Movement Day (a Sunday), and March 2 is its substitute holiday. The deadline is Tuesday, March 3.

4. Counting business days in a range

kr_count_business_days {"from": "2026-10-01", "to": "2026-10-31"}
→ business_days: 20 (31 calendar days, 9 weekend days, 2 weekday holidays)

What it does not do

Other tools on the same server

Korean lunar calendar conversion (2027 Lunar New Year is Feb 7 in Korea and Feb 6 in China), phrases like "다음 주 화요일" to dates, won amounts in Korean words, character and NEIS byte counts, business registration number check digits, and phone/address/name cleanup. Full list: home, OpenAPI, llms.txt.

More on Civil Act periods (weeks, years, periods that start at 00:00): Korean legal deadlines guide.

The Quokka Studio · contact@thequokkacompany.com