About japan-business-calendar-mcp
japan-business-calendar-mcp is an MCP server for checking Japan’s official national holidays and calculating business days. It uses bundled Cabinet Office data, so calculations work offline and follow the stated rule that weekends and national holidays are non-business days.
Key features
- 01Classify dates and find nearby business days
- 02Count business days across a date range
- 03Find the n-th business day before or after a date
- 04List national holidays by year
- 05List business days for a calendar month
- 06Show data source, license, and coverage
Use cases
- 01Check whether a date is a Japanese business day
- 02Count working days between two dates
- 03Find a deadline or next business date
- 04Review national holidays for a year
MCP support
Exposes six tools for date analysis, business-day calculations, holiday and business-day listings, and data metadata. The README describes both stdio MCP use and an Apify-hosted endpoint.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJapan Business Day & Holiday Calculator MCP
MCP server exposing Japan's official national holidays and business-day arithmetic to AI agents. Data is the Cabinet Office (内閣府) official 国民の祝日・休日 list — deterministic, offline-safe, no network at runtime.
What it does
| Tool | Description |
|---|---|
analyze_date | Is a date a business day, a national holiday, or a weekend? Nearest business days. |
count_business_days | Inclusive business-day count over a date range. |
next_business_day | n-th business day before/after a date. |
list_holidays | Full national holiday list, optionally filtered by year. |
list_business_days | All business days in a Japanese calendar month. |
data_summary | Seed metadata: source, license, coverage. |
REST mirror (OpenAPI): /rest/analyze, /rest/count, /rest/next,
/rest/holidays, /rest/business-days, /rest/summary, /health, /openapi.json.
Data & attribution
- Source: Cabinet Office (内閣府) 国民の祝日・休日 — https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv
- License: Government Standard Terms of Use (出典明示で商用利用可)
- Coverage: 1955-01-01 → 2027-11-23 (1,067 holidays), bundled as
data/japan_holidays.json(~63 KB). - Business-day rule: not a national holiday and not Saturday/Sunday.
Local run
uv run --directory . src/stdio_main.py # stdio MCP (Claude Desktop / Cursor)
JBC_DATA_DIR=. python3 tests/test_jbc.py # smoke: 6 MCP tools + 8 REST endpoints
Deployment
Apify Actor japan-business-calendar-mcp (Standby mode,
webServerMcpPath=/mcp, Dockerfile CMD ["python", "-m", "src.main"]):
https://fruitful-quintessence--japan-business-calendar-mcp.apify.actor/mcp
Apify Store
This MCP server is also available as a managed Apify Actor (PPE课金):
- Apify Store: japan-business-calendar-mcp — Japanese business days & national holidays from the Cabinet Office official list. Run from the Apify Store (Run button), then point your MCP client at the endpoint.
Install via Smithery
Connect this MCP server to your AI client (Claude Desktop, Cursor, VS Code) in one command:
npx @smithery/cli install atushi1841/japan-business-calendar-mcp --client claude
Replace claude with cursor, vscode, or cline for other clients.
Alternatively, install directly from the Smithery registry.
MCP Registry
This server is registered on the official MCP Registry. Find it via search: japan-business-calendar-mcp
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.