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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues