# japan-holiday-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 337 installs
- Author: kakar-satoshi
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/kakar-satoshi/japan-holiday-mcp
- Updated: 2026-06-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/japan-holiday-mcp

## What it 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.

## Requirements
- Remote server: `https://japan-holiday-mcp--kakar-satoshi.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add japan-holiday-mcp --url https://japan-holiday-mcp--kakar-satoshi.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "japan-holiday-mcp": {
            "url": "https://japan-holiday-mcp--kakar-satoshi.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "japan-holiday-mcp": {
            "type": "http",
            "url": "https://japan-holiday-mcp--kakar-satoshi.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http japan-holiday-mcp https://japan-holiday-mcp--kakar-satoshi.run.tools
```

## When to use it
- 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
- 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?

## Similar
- [PlugRail Japanese Calendar](https://affpapa.org/en/nevibecode/mcp/plugrail-japanese-calendar.md) — MCP server
- [Japan in Seasons](https://affpapa.org/en/nevibecode/mcp/japan-in-seasons.md) — MCP server · 4124 installs
- [japan-seasons](https://affpapa.org/en/nevibecode/mcp/japan-seasons.md) — MCP server · 1010 installs
- [Japan Business MCP](https://affpapa.org/en/nevibecode/mcp/japan-business-mcp.md) — MCP server · 800 installs
- [japan-weather-alert-mcp](https://affpapa.org/en/nevibecode/mcp/japan-weather-alert-mcp.md) — MCP server · 202 installs
- [japan-data-mcp](https://affpapa.org/en/nevibecode/mcp/japan-data-mcp.md) — MCP server · ★ 13 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
