Skip to content
MCP server

Korea Business Calendar

Korean public holidays, business-day math and tax and payroll deadlines, without any keys

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About Korea Business Calendar

Korea Business Calendar is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-kr-biz-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kr-biz-calendar"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-kr-biz-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-kr-biz-calendar"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free npm package; no keys

Prices change. Check appmonster.co.kr before you buy.

Korea Business Calendar 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 to Korea Business Calendar

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity