
jp-calendar
io.github.nick353/jp-calendar
Japanese national holidays, business days and wareki (era) dates, exact not guessed. No API key.
Documentation
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:
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
npm install
npm test
npm run dev
MIT License.
No installation packages available.