Repository avatar
Other Tools
v0.1.0
active

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

ToolWhat it does
check_dateHoliday? weekend? business day? plus wareki
list_holidaysHolidays between two dates (≤ 5 years)
add_business_daysDate ± N business days (due dates like "within 5 business days")
count_business_daysBusiness days between two dates
to_wareki2019-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.