# Hudy

> Queries Korean public holidays and performs business day calculations via the HuDy MCP server, including counting business days and managing custom holidays.

- Skill: `johnalbertini14-glitch/hudy` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add johnalbertini14-glitch/hudy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/hudy/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, Email & Calendar
- Tags: Business Days, Calendar, Hudy, Korean Holidays, Mcp
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/johnalbertini14-glitch/hudy

---


# HuDy - Korean Holiday & Business Day Skill

Use the HuDy MCP server to query Korean public holidays, calculate business days, and manage custom holidays directly from your AI agent.

## Setup

### 1. Get an API Key

Sign up at [hudy.co.kr](https://www.hudy.co.kr) and create an API key from the dashboard.

### 2. Connect MCP

**Claude Code:**

```bash
claude mcp add --transport http hudy https://www.hudy.co.kr/api/mcp -H "x-api-key: YOUR_API_KEY"
```

**Claude Desktop / Cursor:**

```json
{
  "mcpServers": {
    "hudy": {
      "url": "https://www.hudy.co.kr/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}
```

---

## Available Tools

### `get_holidays` (Free)

Query Korean public holidays by year or date range.

```text
"2026년 공휴일 알려줘"
"2026-03-01부터 2026-06-30까지 공휴일 조회해줘"
```

### `count_business_days` (Pro)

Count business days between two dates, excluding weekends and public holidays.

```text
"2026-03-01부터 2026-03-31까지 영업일 며칠이야?"
"이번 달 영업일 수 알려줘"
```

### `add_business_days` (Pro)

Calculate the date N business days after a given date.

```text
"2026-03-01에서 10영업일 후 날짜 알려줘"
"오늘부터 5영업일 뒤는 언제야?"
```

### `subtract_business_days` (Pro)

Calculate the date N business days before a given date.

```text
"2026-03-31에서 5영업일 전 날짜 알려줘"
```

### `check_business_day` (Pro)

Check if a specific date is a business day.

```text
"2026-03-01이 영업일이야?"
"오늘 영업일인지 확인해줘"
```

### Custom Holiday Management (Pro)

Manage user-defined holidays that are included in all business day calculations.

| Tool | Description |
| --- | --- |
| `list_custom_holidays` | List all custom holidays |
| `create_custom_holiday` | Register a new custom holiday |
| `update_custom_holiday` | Update an existing custom holiday |
| `delete_custom_holiday` | Delete a custom holiday |

```text
"회사 창립기념일 2026-05-15로 등록해줘"
"커스텀 공휴일 목록 보여줘"
```

---

## Plans

| Feature | Free | Pro ($3/mo) |
| --- | :---: | :---: |
| Public holiday lookup | ✅ | ✅ |
| Monthly API calls | 100 | 5,000 |
| Business day APIs | ❌ | ✅ |
| Custom holidays | ❌ | ✅ |
| Calendar sync (iCal) | ❌ | ✅ |

---

## Notes

- All dates use `YYYY-MM-DD` format.
- Holiday data is sourced from the Korean government open data portal (data.go.kr).
- Custom holidays are per-user and automatically included in business day calculations.
- Calendar sync provides an iCal URL for Google Calendar, Apple Calendar, and Outlook.