Skip to main content
Glama
Japan Calendar MCP

Japan Calendar MCP

by nick353

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.

Related MCP server: jp-business-calendar-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Japanese business calendar operations such as holiday checking, business day calculations, payment date calculation, fiscal year determination, and deadline tracking, all locally without external API.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to perform Japanese business calendar calculations including holiday detection, business day arithmetic, payment date settlement, and deadline management using local data.
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides accurate Japanese business day utilities including holiday checks, settlement day calculations, and fiscal period determination, all with embedded holiday data from 2020-2030.
      7
      MIT