Skip to main content
Glama
Japan Calendar MCP

Japan Calendar MCP

by nick353
README.md
# Japan Calendar MCP

An MCP server that answers Japanese calendar questions exactly, so your agent stops guessing:

- **National holidays** — official Cabinet Office of Japan list (1955–2027), names in Japanese and English
- **Business days** — add/subtract or count, skipping weekends and holidays; optional Dec 31 – Jan 3 year-end break
- **Wareki (Japanese era dates)** — 令和/平成/昭和/大正/明治 ⇄ Gregorian, including 元年, kanji numerals and short forms like `R8.11.18`; rejects dates that never existed (e.g. 平成31年5月1日)

No API key, no sign-in. Read-only tools.

## Connect

Streamable HTTP endpoint: `https://jp-calendar-mcp.nichika2000823.workers.dev/mcp`

Claude Code:

```bash
claude mcp add --transport http jp-calendar https://jp-calendar-mcp.nichika2000823.workers.dev/mcp
```

Any MCP client that supports remote (Streamable HTTP) servers works the same way: Cursor, VS Code, ChatGPT, Gemini CLI.

## Tools

| Tool | What it does |
|---|---|
| `check_date` | Holiday? weekend? business day? plus wareki |
| `list_holidays` | Holidays between two dates (≤ 5 years) |
| `add_business_days` | Date ± N business days (due dates like "within 5 business days") |
| `count_business_days` | Business days between two dates |
| `to_wareki` | 2019-05-01 → 令和元年5月1日 / R1.5.1 |
| `from_wareki` | 平成三十一年四月三十日 → 2019-04-30 |

Dates outside the official holiday data return an error instead of a guess.

## 日本語

日本の祝日(内閣府の公式データ)・営業日の計算・和暦⇄西暦を、推測ではなく正確に答える MCP サーバーです。鍵もサインインも要りません。

## Data and privacy

Holiday data: 内閣府「国民の祝日について」(https://www8.cao.go.jp/cao/chosei/shukujitsu/gaiyou.html), used under the Government of Japan Standard Terms of Use (compatible with CC BY 4.0). Rebuild with `npm run build:holidays`.

Usage is counted with a salted hash of the caller that rotates every two weeks; raw IP addresses are not stored.

## Develop

```bash
npm install
npm test
npm run dev
```

MIT License.