Skip to content
MCP server

PlugRail Japanese Calendar

Japanese public holiday checks and business-day arithmetic from Cabinet Office data

Install
Pricing
Free
Platforms
API, self-hosted
Runs
Remotely
Version
0.2.0
Listing updated
2 days ago

About PlugRail Japanese Calendar

PlugRail Japanese Calendar is a free MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://jp-calendar.plugrail.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "jp-calendar": {
      "url": "https://jp-calendar.plugrail.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free and anonymous

Prices change. Check plugrail.dev before you buy.

PlugRail Japanese Calendar 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 to PlugRail Japanese Calendar

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media