Japan Calendar

● Active

io.github.nick353/jp-calendar

Japanese national holidays, business days and wareki (era) dates, exact not guessed. No API key.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "jp-calendar": {
      "url": "https://jp-calendar-mcp.nichika2000823.workers.dev/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http jp-calendar https://jp-calendar-mcp.nichika2000823.workers.dev/mcp
VS Code
code --add-mcp '{"name":"jp-calendar","type":"http","url":"https://jp-calendar-mcp.nichika2000823.workers.dev/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Productivity
Version
0.1.0
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Japan Calendar is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 4 days ago (Nov 18, 2026), 0 open issues.
Official registry
Active
Published as io.github.nick353/jp-calendar in the official MCP registry, version 0.1.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to jp-calendar-mcp.nichika2000823.workers.dev: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Working60 msprotocol 2025-06-18v0.1.0tools

The endpoint answered the MCP handshake as "Japan Calendar (holidays, business days, wareki)" and listed 6 tools. Answering since Nov 18, 2026.

Context cost ≈ 961 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 6 tools.

Tools (6)

  • check_date2 params

    Tell whether a date is a Japanese national holiday, a weekend, or a business day, with the holiday name (Japanese and English) and the wareki date.

    Show parameters
    • datestringrequiredDate to check, YYYY-MM-DD
    • year_end_breakbooleanAlso treat Dec 31 - Jan 3 as non-business days (common for banks and most Japanese companies). Default false.
  • list_holidays2 params

    List Japanese national holidays (including substitute holidays) between two dates, up to 5 years.

    Show parameters
    • fromstringrequiredFirst date, YYYY-MM-DD
    • tostringrequiredLast date, YYYY-MM-DD
  • add_business_days3 params

    Move forward (or backward with a negative number) by N business days in Japan, skipping weekends and national holidays. Use for due dates such as "within 5 business days".

    Show parameters
    • datestringrequiredStart date, YYYY-MM-DD (not counted)
    • daysintegerrequiredBusiness days to add; negative goes back
    • year_end_breakbooleanAlso treat Dec 31 - Jan 3 as non-business days (common for banks and most Japanese companies). Default false.
  • count_business_days4 params

    Count business days in Japan between two dates (both ends included unless include_start is false).

    Show parameters
    • fromstringrequiredFirst date, YYYY-MM-DD
    • tostringrequiredLast date, YYYY-MM-DD
    • include_startbooleanCount the first date too. Default true.
    • year_end_breakbooleanAlso treat Dec 31 - Jan 3 as non-business days (common for banks and most Japanese companies). Default false.
  • to_wareki1 param

    Convert a Gregorian date to a Japanese era date (wareki), e.g. 2019-05-01 -> 令和元年5月1日 (R1.5.1). Supports dates from 1873-01-01.

    Show parameters
    • datestringrequiredGregorian date, YYYY-MM-DD
  • from_wareki1 param

    Convert a Japanese era date to a Gregorian date. Accepts 令和8年11月18日, 令和元年5月1日, 平成三十一年四月三十日, R8.11.18, H31/4/30, Reiwa 8.11.18. Rejects dates that did not exist in that era (e.g. 平成31年5月1日).

    Show parameters
    • textstringrequiredJapanese era date text

Checked by Serverdex with a plain initialize + tools/list call to jp-calendar-mcp.nichika2000823.workers.dev/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 18, 2026
License
MIT

TypeScript

From the README

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: Any MCP client that supports remote (Streamable HTTP) servers works the same way: Cursor, VS Code, ChatGPT, Gemini CLI. Tools 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 MIT License.

Read the full README on GitHub →

Remotes

  • streamable-httphttps://jp-calendar-mcp.nichika2000823.workers.dev/mcp

The most-starred Productivity servers in the index, with their live-check result.

ServerStarsLast pushLive check
Front-End Checklist74,746Oct 2026Working
Windmill18,600Nov 2026Needs sign-in
Agent-Native Content7,735Nov 2026Needs sign-in
Agent-Native Calendar7,735Nov 2026Needs sign-in
Agent-Native Plan7,735Nov 2026Needs sign-in

Japan Calendar: questions people ask

Is Japan Calendar a remote or a local MCP server?
According to its entry in the official MCP registry, Japan Calendar ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Japan Calendar need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Japan Calendar safe to use?
Looks healthy: Japan Calendar is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Japan Calendar still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
What tools does Japan Calendar expose?
6 tools as listed by the server itself during the live check, including check_date, list_holidays, add_business_days, count_business_days, to_wareki. The full list with parameters is in the Live check section above.
How do I add Japan Calendar to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. Japan Bank CodeJapanese bank/branch codes with kana, transfer pre-checks, Japan Post Bank conversion. No API key.
  2. Japan Business IDValidate Japanese invoice registration numbers (T+13) and corporate numbers. No API key.
Browse all Productivity →

Add the badge to your site

Show visitors that Japan Calendar is listed here — it’s also the link we check for a free listing.

Japan Calendar — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-nick353-jp-calendar?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Japan Calendar — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Japan Calendar — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-nick353-jp-calendar?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-nick353-jp-calendar) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-nick353-jp-calendar) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-nick353-jp-calendar)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-nick353-jp-calendar"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-nick353-jp-calendar"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-nick353-jp-calendar"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).