# PlugRail Japanese Calendar

> PlugRail Japanese Calendar is a free MCP server for productivity. Japanese public holiday checks and business-day arithmetic from Cabinet Office data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, self-hosted
- **Website:** https://plugrail.dev
- **Repository:** https://github.com/plugrail/servers
- **MCP Registry name:** dev.plugrail/jp-calendar
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

jp-calendar is the first live server in the plugrail collection, which connects AI agents to Japanese public data. It answers the question "when is the next business day?" using the holiday list published by Japan's Cabinet Office, so an agent can check a date, list holidays, count business days between two dates, or add a number of business days to a date.

The hosted endpoint needs no sign-in. Replies follow a shared envelope: the data, the source name and URL with its licence (Public Data Use Terms 1.0), the fetch time, the as-of time of the data and a disclaimer saying it is reference information, not an official view. An example is_holiday response for 2026-01-01 returns the holiday name, weekday and weekend flag.

The README describes a Cloudflare Workers design with D1 for holiday data and KV for caching, and gives self-hosting steps; authentication, rate limiting and metering exist only in the hosted service. Code is MIT licensed. It is not an official service of any Japanese government body.

## Features

- **Holiday lookup:** Checks whether a date is a Japanese public holiday and names it.
- **Business-day maths:** Adds N business days or counts business days between two dates.
- **Cited responses:** Each reply carries the source, licence, fetch time and a disclaimer.
- **Anonymous access:** The hosted endpoint works without registration or a key.
- **Self-hostable:** Deploys to Cloudflare Workers with D1 and KV.
- **Official data source:** Built on the Cabinet Office national holidays page.

## Good for

- Find the next business day for a Japanese deadline
- Count working days in a billing period
- Check if a date is a national holiday
- Schedule deliveries around Japanese holidays
- Add a payment term in business days

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://jp-calendar.plugrail.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `is_holiday`: Checks whether a date is a Japanese public holiday.
- `list_holidays`: Lists Japanese public holidays.
- `business_days_between`: Counts business days between two dates.
- `add_business_days`: Adds a number of business days to a date.

## FAQ

### Do I need to sign in?

No. The hosted endpoint is anonymous and free.

### Where does the holiday data come from?

The Cabinet Office national holidays page, used under the Public Data Use Terms 1.0.

### Which tools does it offer?

is_holiday, list_holidays, business_days_between and add_business_days.

### Can I host it myself?

Yes, on Cloudflare with D1 and KV, though auth, rate limiting and metering are hosted-only.

### Is PlugRail Japanese Calendar free?

Yes. PlugRail Japanese Calendar is free to use.

### How do I add PlugRail Japanese Calendar to Claude Code?

Run this command in your terminal: claude mcp add --transport http jp-calendar https://jp-calendar.plugrail.dev/mcp

### What are the best alternatives to PlugRail Japanese Calendar?

The closest alternatives to PlugRail Japanese Calendar are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/plugrail-japanese-calendar
