Japan Calendar
● Activeio.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.
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"
}
}
}claude mcp add --transport http jp-calendar https://jp-calendar-mcp.nichika2000823.workers.dev/mcpcode --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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks 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 →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 paramsTell 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 parametersHide parameters
datestringrequiredDate to check, YYYY-MM-DDyear_end_breakbooleanAlso treat Dec 31 - Jan 3 as non-business days (common for banks and most Japanese companies). Default false.
list_holidays2 paramsList Japanese national holidays (including substitute holidays) between two dates, up to 5 years.
Show parametersHide parameters
fromstringrequiredFirst date, YYYY-MM-DDtostringrequiredLast date, YYYY-MM-DD
add_business_days3 paramsMove 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 parametersHide parameters
datestringrequiredStart date, YYYY-MM-DD (not counted)daysintegerrequiredBusiness days to add; negative goes backyear_end_breakbooleanAlso treat Dec 31 - Jan 3 as non-business days (common for banks and most Japanese companies). Default false.
count_business_days4 paramsCount business days in Japan between two dates (both ends included unless include_start is false).
Show parametersHide parameters
fromstringrequiredFirst date, YYYY-MM-DDtostringrequiredLast date, YYYY-MM-DDinclude_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 paramConvert 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 parametersHide parameters
datestringrequiredGregorian date, YYYY-MM-DD
from_wareki1 paramConvert 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 parametersHide 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-http
https://jp-calendar-mcp.nichika2000823.workers.dev/mcp
Alternatives to Japan Calendar
All Japan Calendar alternatives →Best Productivity servers →The most-starred Productivity servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Front-End Checklist | 74,746 | Oct 2026 | Working |
| Windmill | 18,600 | Nov 2026 | Needs sign-in |
| Agent-Native Content | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Calendar | 7,735 | Nov 2026 | Needs sign-in |
| Agent-Native Plan | 7,735 | Nov 2026 | Needs 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.
More from nick353
All 3 servers by nick353 →More Productivity servers
Browse all Productivity →Corresync
nkiyohara
Local-first mail, calendar, and task MCP with isolated accounts and guarded writes.
Noeto
noeto-tasks
Work a Noeto kanban board: read and search it, create, move and comment on cards, keep docs on them.
AgentCron
Noriget
Schedule tasks for later from your AI agent: reminders, delayed webhooks, recurring jobs.
Generate-Data
ns-3e
MCP server for Generate-Data.com: dataset generation, AI schema design, Project management.
GenReady
odb366
Scan a website for AI search and agent readiness, then get a fix checklist for your agent.
Drop Spot
officialdropspot
Passwordless client document intake, checklist tracking, and 1-click file reviews for Drop Spot.
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-nick353-jp-calendar) [](https://serverdex.io/install/vscode/io-github-nick353-jp-calendar) [](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).