japan-holiday-mcp — Claude Code MCP server: what it does
japan-holiday-mcp tells you whether a date is a Japanese public holiday, lists a month's holidays and the next ones coming up. Cabinet Office data, no API key.
no license 337 installs updated 2026-06-01
claude mcp add --transport http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.toolsWhat japan-holiday-mcp does
The toolset is small and each tool does one thing. is_holiday takes a date and hands back the holiday name when there is one. get_holidays_in_month returns everything marked in a given year and month. get_next_holidays counts forward from today on Japan Standard Time and reports the gap in days. ping exists to prove the connection works.
Holidays and substitute holidays both come from 内閣府, the Cabinet Office. The server is remote and lives at https://japan-holiday-mcp--kakar-satoshi.run.tools. Nothing is signed up for and no API key changes hands, so setup means dropping that URL into your client's config.
Because the reference time is Japanese, your own timezone does not shift the countdown in get_next_holidays. If that host is unreachable, none of the tools answer — one HTTP endpoint is the whole server.
What it helps with
- check whether a deadline falls on a Japanese public holiday
- pull a month's holidays before booking a release window
- find how many days are left until the next day off in Japan
- get the name of the holiday on a specific date
- test that the endpoint responds before adding it to an agent
Example prompts for the agent
- Is tomorrow a national holiday in Japan? Give me the name.
- List every Japanese holiday this month.
- Which holidays are coming up in Japan, and how far off is each one?
How to install japan-holiday-mcp
Platform CLI: remote server
claude mcp add --transport http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.toolsPlatform CLI: remote server
codex mcp add japan-holiday-mcp --url https://japan-holiday-mcp--kakar-satoshi.run.toolsConfig file
{
"mcpServers": {
"japan-holiday-mcp": {
"url": "https://japan-holiday-mcp--kakar-satoshi.run.tools"
}
}
}Config file
{
"servers": {
"japan-holiday-mcp": {
"type": "http",
"url": "https://japan-holiday-mcp--kakar-satoshi.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about japan-holiday-mcp
How do I install japan-holiday-mcp in Claude Code?
Run claude mcp add --transport http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.tools. That one command registers the remote server.
What does japan-holiday-mcp do?
It answers holiday questions about Japan: whether a given date is a public holiday, what falls inside a month, and which holidays come next.
Do I need an API key?
No. The server is reached over HTTP at https://japan-holiday-mcp--kakar-satoshi.run.tools, and the config needs nothing beyond that URL.