Is Japan Business Calendar free?

Yes, Japan Business Calendar is free to use.

How do I install Japan Business Calendar?

Japan Business Calendar is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Japan Business Calendar safe to use?

Japan Business Calendar scored 5.7/10 (moderate risk) in MCP Marketplace's automated security scan. It has 7 high or critical findings to review. It's listed, but review the security report on this page before installing.

What AI apps work with Japan Business Calendar?

Japan Business Calendar uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Japan Business Calendar MCP Server

by Atushi1841

Developer ToolsModerate5.7MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.7

Moderate5.7Moderate Risk

This is a read-only Japanese holiday and business-day calculator that uses a bundled offline seed and makes no outbound network calls at runtime, so its permissions match its purpose. The findings are minor: the REST layer is unauthenticated (acceptable for public data) and binds to 0.0.0.0, the developer-only packing script runs git push and gh release upload, an unused httpx dependency is declared, and there are small code-quality issues such as a duplicated analyze call and a dead loop in _parse_date. Supply chain analysis found 13 known vulnerabilities in dependencies (1 critical, 6 high severity).

13 files analyzed · 19 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-atushi1841-japan-business-calendar-mcp": {
      "args": [
        "japan-business-calendar-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.