Repository avatar
Other Tools
v0.1.0
active

japan-business-calendar-mcp

io.github.atushi1841/japan-business-calendar-mcp

Japan business day & holiday calculator MCP. Official holidays + business-day arithmetic, 6 tools.

Documentation

Japan 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

ToolDescription
analyze_dateIs a date a business day, a national holiday, or a weekend? Nearest business days.
count_business_daysInclusive business-day count over a date range.
next_business_dayn-th business day before/after a date.
list_holidaysFull national holiday list, optionally filtered by year.
list_business_daysAll business days in a Japanese calendar month.
data_summarySeed 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

MCPB
https://github.com/atushi1841/japan-business-calendar-mcp/releases/download/v0.1.0/server.mcpb
Install Command
# mcpb: https://github.com/atushi1841/japan-business-calendar-mcp/releases/download/v0.1.0/server.mcpb