PlugRail Japanese Calendar
RemoteAbout PlugRail Japanese Calendar
PlugRail Japanese Calendar is an MCP server for checking Japanese holidays and calculating business days from Cabinet Office source data. It suits applications and workflows that need Japan-specific date calculations.
Key features
- 01Check whether a date is a holiday
- 02List Japanese public holidays
- 03Count business days between dates
- 04Add business days to a date
Use cases
- 01Verify whether a date is a Japanese holiday
- 02Calculate working-day spans for schedules
MCP support
The live jp-calendar endpoint exposes holiday and business-day tools to MCP clients. A self-hosted version can also be deployed.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://jp-calendar.plugrail.dev/mcpclaude mcp add --transport http plugrail-jp-calendar https://jp-calendar.plugrail.dev/mcp{"mcpServers":{"plugrail-jp-calendar":{"type":"http","url":"https://jp-calendar.plugrail.dev/mcp"}}}Open in Cursor{"servers":{"plugrail-jp-calendar":{"type":"http","url":"https://jp-calendar.plugrail.dev/mcp"}}}Open in VS Code{"mcpServers":{"plugrail-jp-calendar":{"type":"http","url":"https://jp-calendar.plugrail.dev/mcp"}}}{"mcpServers":{"plugrail-jp-calendar":{"serverUrl":"https://jp-calendar.plugrail.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| date | string | Yes | A date in YYYY-MM-DD format. Example: "2026-01-01" |
Details
From the project READMEplugrail
A collection of MCP servers that connect to Japanese public data. The name alone does not describe the project, so plugrail is not related to railways or railway services.
Live servers
| Server | MCP endpoint | Tools | Status |
|---|---|---|---|
| jp-calendar | https://jp-calendar.plugrail.dev/mcp | is_holiday, list_holidays, business_days_between, add_business_days | Live |
Connect
See the jp-calendar connection guide.
Self-hosting
- In
packages/servers/jp-calendar/, copywrangler.example.jsonctowrangler.jsoncand fill in your Cloudflare resource IDs. - Create the D1 database and KV namespace referenced by that configuration.
- Run
pnpm --filter @plugrail/jp-calendar deploy.
The self-hosted server runs independently. Authentication, rate limiting, and usage metering are features of the hosted service only.
Architecture
MCP client
|
v
jp-calendar Worker --> Cloudflare D1 (holiday data)
--> Cloudflare KV (cached data)
Sources and disclaimer
This is not an official service of the National Tax Agency, the Digital Agency, or any other Japanese government body. Information provided does not represent their official views and is not guaranteed by them.
Source: Adapted from the Cabinet Office "National Holidays" page (https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html)
Contributing
Issues and pull requests are welcome. Please include enough context to reproduce a problem or explain a proposed change.
License
MIT. See LICENSE.
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.