# Korea Business Calendar

> Korea Business Calendar is an open-source MCP server for productivity. Korean public holidays, business-day math and tax and payroll deadlines, without any keys. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/kr-biz-calendar
- **MCP Registry name:** io.github.groove79/mcp-kr-biz-calendar
- **Categories:** productivity, finance and payments
- **Listing updated:** 2026-11-15

## About

Filing dates in Korea shift when they land on a weekend or holiday, which makes manual date checking error-prone. This server runs entirely offline and computes holidays, business-day arithmetic and a deadline calendar for a given business profile.

Holidays include substitute holidays under the 2023 amendment and election days, with the lunar holidays (설날, 추석, 부처님오신날) tabled for 2025 to 2028. For other years you pass extra holidays in. The tax calendar covers value-added tax, income and corporate tax, monthly withholding and social insurance on the 10th, payment statements and year-end settlement, and moves each date to the next business day as the national tax law requires.

The README says it encodes standard rules for a December-year-end company and calendar-year individuals; special regimes are described but not computed, and it is a scheduling aid, not tax advice.

## Features

- **Holiday lists:** Public holidays by year, including substitute holidays and election days.
- **Business-day checks:** Tells whether a date is a business day and gives the next or previous one.
- **Business-day arithmetic:** Adds or subtracts business days and counts them between two dates.
- **Deadline calendar:** Filing dates by business type and employment status, filterable by month or upcoming days.
- **Rule explanations:** Describes what each deadline is, who owes it and when.
- **No keys, no network:** Works offline with no credentials.

## Good for

- Ask what a company must file this month
- Work out an arrival date three business days from now
- Check when a filing due on a Sunday is really due
- List the year's public holidays for planning

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-kr-biz-calendar -- npx -y @appmonster/mcp-kr-biz-calendar
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `kr_list_holidays`: Public holidays by year including substitute holidays and election days.
- `kr_is_business_day`: Whether a date is a business day, with the next and previous business day.
- `kr_add_business_days`: Adds or subtracts business days and counts business days between dates.
- `kr_tax_calendar`: Tax and payroll deadlines by business type and employment, filtered by month or upcoming days.
- `kr_tax_rule`: Explains a calendar item: what, who and when.

## FAQ

### Which years are covered?

The built-in lunar holiday table covers 2025 to 2028; for other years you supply extra holidays.

### Which business types does the calendar handle?

Individual, simplified, corporation and tax-exempt, with or without employees.

### Is it tax advice?

No. The README calls it a scheduling aid and says to confirm with Hometax notices.

### Does it need an API key?

No keys and no network access.

### Is Korea Business Calendar free?

Yes. Korea Business Calendar is open source, so you can use and self-host it for free.

### How do I add Korea Business Calendar to Claude Code?

Run this command in your terminal: claude mcp add mcp-kr-biz-calendar -- npx -y @appmonster/mcp-kr-biz-calendar

### What are the best alternatives to Korea Business Calendar?

The closest alternatives to Korea Business Calendar are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/korea-business-calendar
