Japan & World Public Holidays
Public holidays, business days and long weekends for Japan (Cabinet Office) and 245 other countries.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"holiday": {
"url": "https://holiday.omikuji.dev/mcp"
}
}
}Remote endpoints
https://holiday.omikuji.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢check_dates(dates, year_end_closed, country, region, include_government)
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 调休).
Input Schema
{
"type": "object",
"properties": {
"dates": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"minItems": 1,
"maxItems": 62
},
"year_end_closed": {
"type": "boolean",
"default": false,
"description": "Japan only: treat 12/29-1/3 as non-business days (common in Japanese companies)."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "JP",
"description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
},
"region": {
"type": "string",
"description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
},
"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."
}
},
"required": [
"dates"
],
"additionalProperties": false
}🟢list_holidays(year, from, to, limit, country, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (default: today in Japan)."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date (inclusive)."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "JP",
"description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
},
"region": {
"type": "string",
"description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
},
"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
}🟢business_days(start, end, add, year_end_closed, country, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Count up to this date (inclusive)."
},
"add": {
"type": "integer",
"minimum": -2000,
"maximum": 2000,
"description": "Move this many business days from start."
},
"year_end_closed": {
"type": "boolean",
"default": false,
"description": "Japan only."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "JP",
"description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
},
"region": {
"type": "string",
"description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
},
"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."
}
},
"required": [
"start"
],
"additionalProperties": false
}🟢find_long_weekends(year, from, min_length, limit, country, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"year": {
"type": "integer"
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "List long weekends ending on or after this date (default: today in Japan)."
},
"min_length": {
"type": "integer",
"minimum": 3,
"maximum": 10,
"default": 3
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "JP",
"description": "ISO 3166-1 alpha-2 country code (e.g. JP, US, CN, GB). Default JP."
},
"region": {
"type": "string",
"description": "Outside Japan: state/province code (ISO 3166-2 suffix, e.g. CA for California) to include regional holidays."
},
"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
}Community
Evidence