Japan & World Public Holidays

Working · 1.8 s

dev.omikuji/holidayv1.1.0 Domain verified

Public holidays, business days and long weekends for Japan (Cabinet Office) and 245 other countries.

Utilities

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://holiday.omikuji.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

business_days Read-only

Count business days between start and end (inclusive), or find the date that is N business days after start (add=N; negative N goes backward; start itself is not counted). Business day = weekday that is not a national holiday. Set year_end_closed to also skip 12/29-1/3. With country, uses that country's weekend days, holidays and make-up workdays.

startstring, required

YYYY-MM-DD

addinteger

Move this many business days from start.

endstring

Count up to this date (inclusive).

regionstring

Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays.

countrystring

ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP.

year_end_closedboolean

Japan only.

include_governmentboolean

Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off.

Tools (4)

business_days

read-only

Argument	Type	Description
add	integer	Move this many business days from start.
end	string	Count up to this date (inclusive).
start*	string	YYYY-MM-DD
region	string	Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays.
country	string	ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP.
year_end_closed	boolean	Japan only.
include_government	boolean	Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "start"
  ],
  "properties": {
    "add": {
      "type": "integer",
      "maximum": 2000,
      "minimum": -2000,
      "description": "Move this many business days from start."
    },
    "end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Count up to this date (inclusive)."
    },
    "start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD"
    },
    "region": {
      "type": "string",
      "description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
    },
    "country": {
      "type": "string",
      "default": "JP",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
    },
    "year_end_closed": {
      "type": "boolean",
      "default": false,
      "description": "Japan only."
    },
    "include_government": {
      "type": "boolean",
      "default": false,
      "description": "Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off."
    }
  },
  "additionalProperties": false
}

check_dates

For each date, tell whether it is a Japanese national holiday (with name and kind: 祝日 / 振替休日 / 国民の休日), a weekend, and a business day. Also returns today in Japan time. With country, the same for that country (holiday names, status, make-up workdays such as China's 调休).

read-only

Argument	Type	Description
dates*	array
region	string	Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays.
country	string	ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP.
year_end_closed	boolean	Japan only: treat 12/29-1/3 as non-business days (common in Japanese companies).
include_government	boolean	Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "dates"
  ],
  "properties": {
    "dates": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
        "description": "YYYY-MM-DD"
      },
      "maxItems": 62,
      "minItems": 1
    },
    "region": {
      "type": "string",
      "description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
    },
    "country": {
      "type": "string",
      "default": "JP",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
    },
    "year_end_closed": {
      "type": "boolean",
      "default": false,
      "description": "Japan only: treat 12/29-1/3 as non-business days (common in Japanese companies)."
    },
    "include_government": {
      "type": "boolean",
      "default": false,
      "description": "Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off."
    }
  },
  "additionalProperties": false
}

find_long_weekends

Find 連休 (3+ consecutive days off made of weekends and national holidays), e.g. Golden Week, Silver Week. Give a year, or from (default today) to list upcoming ones. With country, the same for that country.

read-only

Argument	Type	Description
from	string	List long weekends ending on or after this date (default: today in Japan).
year	integer
limit	integer
region	string	Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays.
country	string	ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP.
min_length	integer
include_government	boolean	Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "List long weekends ending on or after this date (default: today in Japan)."
    },
    "year": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    },
    "region": {
      "type": "string",
      "description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
    },
    "country": {
      "type": "string",
      "default": "JP",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
    },
    "min_length": {
      "type": "integer",
      "default": 3,
      "maximum": 10,
      "minimum": 3
    },
    "include_government": {
      "type": "boolean",
      "default": false,
      "description": "Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off."
    }
  },
  "additionalProperties": false
}

list_holidays

List Japanese national holidays for a year, or between from and to. With no arguments, lists the next 10 holidays from today (Japan time). With country, lists that country's public holidays (and make-up workdays, if any).

read-only

Argument	Type	Description
to	string	End date (inclusive).
from	string	Start date (default: today in Japan).
year	integer
limit	integer
region	string	Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays.
country	string	ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP.
include_government	boolean	Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date (inclusive)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date (default: today in Japan)."
    },
    "year": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "region": {
      "type": "string",
      "description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
    },
    "country": {
      "type": "string",
      "default": "JP",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
    },
    "include_government": {
      "type": "boolean",
      "default": false,
      "description": "Outside Japan: also treat days off only for government offices (e.g. Indonesia's cuti bersama, Canadian federal holidays) as days off."
    }
  },
  "additionalProperties": false
}