PlugRail Japanese Calendar
Japanese holiday and business-day calculations using official Japan Cabinet Office data.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http plugrail-japanese-calendar 'https://jp-calendar.plugrail.dev/mcp'
{
"mcpServers": {
"plugrail-japanese-calendar": {
"type": "http",
"url": "https://jp-calendar.plugrail.dev/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
plugrail
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.
Frequently asked questions
What is PlugRail Japanese Calendar?
Japanese holiday and business-day calculations using official Japan Cabinet Office data.
How do I install PlugRail Japanese Calendar?
It runs as a remote server. In Claude Code: claude mcp add --transport http plugrail-japanese-calendar 'https://jp-calendar.plugrail.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does PlugRail Japanese Calendar need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is PlugRail Japanese Calendar open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains PlugRail Japanese Calendar?
It is published by plugrail. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.