ProductivityMCP Registryremote4 toolsB · 73

PlugRail Japanese Calendar MCP server

Name: PlugRail Japanese Calendar
Author: plugrail.dev

dev.plugrail · Updated 22d ago

Japanese holiday and business-day calculations using official Japan Cabinet Office data.

At a glance

PlugRail Japanese Calendar is an MCP server in the Productivity category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 4 tools, including is_holiday, list_holidays and add_business_days. It scores B (73/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 0

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install PlugRail Japanese Calendar in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install PlugRail Japanese Calendar in Claude CodeAnthropic's agentic CLI

Add the server

bash

claude mcp add --transport http jp-calendar https://jp-calendar.plugrail.dev/mcp

2
Verify it's connected
bash
```
claude mcp list
```
Sharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. is_holiday, list_holidays, add_business_days). It discovers them automatically.

How to install PlugRail Japanese Calendar in Claude DesktopDesktop app (MCP config)

Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server

json

{
  "mcpServers": {
    "jp-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://jp-calendar.plugrail.dev/mcp"
      ]
    }
  }
}

Why the wrapper?
This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install PlugRail Japanese Calendar in CursorAI-first code editor

Create / edit .cursor/mcp.json in your project

json

{
  "mcpServers": {
    "jp-calendar": {
      "url": "https://jp-calendar.plugrail.dev/mcp"
    }
  }
}

Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install PlugRail Japanese Calendar in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

[mcp_servers.jp-calendar]
command = "npx"
args = ["-y", "mcp-remote", "https://jp-calendar.plugrail.dev/mcp"]

Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install PlugRail Japanese Calendar in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "jp-calendar": {
      "serverUrl": "https://jp-calendar.plugrail.dev/mcp"
    }
  }
}

Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install PlugRail Japanese Calendar in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

{
  "mcpServers": {
    "jp-calendar": {
      "type": "streamableHttp",
      "url": "https://jp-calendar.plugrail.dev/mcp"
    }
  }
}

How to install PlugRail Japanese Calendar in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

{
  "servers": {
    "jp-calendar": {
      "type": "http",
      "url": "https://jp-calendar.plugrail.dev/mcp"
    }
  }
}

Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What tools does PlugRail Japanese Calendar expose? (4)

Read from the live server. Click any tool for its input schema.

is_holiday指定した日付が日本の祝日（国民の祝日・休日）かどうかを判定します。内閣府公表データに基づきます。入力例: {"date": "2026-01-01"}
list_holidays指定した年または期間の日本の祝日一覧を返します。入力例: {"year": 2026} または {"from": "2026-01-01", "to": "2026-06-30"}
add_business_days指定した日付(date)の翌日から数えてN営業日目(days)の日付を返します。dateの当日は数えません。daysが負の場合は過去方向（dateの前日から遡ってN営業日目）に計算します。土日・日本の祝日を除外し、calendar="banking"を指定すると銀行休業日（12/31〜1/3）も除外します。dateが営業日かどうかだけ知りたい場合は is_holiday を使ってください（days=0でも同じ情報がskipped経由で得られます）。入力例: {"date": "2026-07-10", "days": 3}
business_days_betweenfrom〜to間の営業日数を数えます。既定では「fromを含まず、toを含む」境界です（例:「今日から支払期日まで何営業日か」）。include_from/include_toで境界を変更できます。土日・日本の祝日を除外し、calendar="banking"を指定すると銀行休業日（12/31〜1/3）も除外します。from > to の場合はエラーにせず、from/toとinclude_from/include_toを入れ替えて計算した結果の符号を反転した値（負の営業日数）を返します（反対称則: count(A,B,x,y) = -count(B,A,y,x)。A≠B、すなわちfrom≠toの場合に成立する恒等式で、from===toはこの分岐に入らないため対象外）。入力例: {"from": "2026-07-10", "to": "2026-07-20"}

What the code can do

This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Third-party hosted service — Your requests and any data in them are sent to jp-calendar.plugrail.dev.
No local execution — Nothing is installed or run on your machine.

Last commit 22 days ago — Actively maintained.
0 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: Via mcp-remoteCursor: NativeCodex CLI: Via mcp-remoteWindsurf: NativeCline: NativeVS Code: Native

Health score

B · 73

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 22 days ago.
Adoption20%0%
0 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%75%
Links to its own repository; package linkage unverified.
Packaging15%75%
Remote endpoint; authentication requirements not declared.

Documentation

Full README

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/, copy wrangler.example.jsonc to wrangler.jsonc and 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

text

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)

Alternatives to PlugRail Japanese Calendar

Maintain PlugRail Japanese Calendar? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![PlugRail Japanese Calendar on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/dev-plugrail-jp-calendar)](https://mcp-skills-hub.vercel.app/mcps/dev-plugrail-jp-calendar)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.