World Public Holidays
Public holidays, business days and long weekends for 247 countries, as MCP tools
- Pricing
- Free
- Platforms
- API
- Runs
- Remotely
- Version
- 1.2.0
- Listing updated
- 2 days ago
About World Public Holidays
World Public Holidays is a free MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.
Holiday questions go wrong when an assistant guesses, and the awkward cases are exactly what this server handles: weekends that fall on Friday and Saturday in parts of the Middle East, China's make-up working days, and arithmetic like 10 business days from today in a given country's local time.
Data runs from last year to two years ahead, and each holiday carries a label: official (checked against government data), rule (computed from legal rules) or estimated (unannounced or dependent on moon sighting). Japan uses Cabinet Office data from 1955 to 2027 with substitute holidays distinguished. Government-only days off count as days off only if include_government is set, and company closures are excluded only on request.
Countries are passed as ISO codes and default to Japan. The server is read-only, takes no personal information and allows 60 requests per minute per client. No sign-up is needed.
Install
Run in a terminal
claude mcp add --transport http holiday https://holiday.omikuji.dev/mcpAdd to Settings → Connectors → Add custom connector
https://holiday.omikuji.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"holiday": {
"url": "https://holiday.omikuji.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"holiday": {
"type": "http",
"url": "https://holiday.omikuji.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"holiday": {
"serverUrl": "https://holiday.omikuji.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"holiday": {
"type": "http",
"url": "https://holiday.omikuji.dev/mcp"
}
}
}Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- check_dates
- Reports whether each date is a public holiday, a weekend and a business day.
- list_holidays
- Lists holidays for a year or date range.
- business_days
- Counts business days in a range or returns the date N business days later.
- find_long_weekends
- Finds runs of 3 or more days off.
What it does
- Per-country weekends
- Handles different weekend days by country.
- Make-up working days
- Counts days such as China's as business days.
- Confidence labels
- Each holiday is marked official, rule or estimated.
- Business-day arithmetic
- Count business days in a range or find the date N business days later.
- Long weekend finder
- Lists runs of three or more days off.
Good for
- Find the date 10 business days from now for a team in China
- List holidays in a given month for a given country
- Work out business days shared by offices in Germany and the UK
- Plan trips around long weekends in India
Pricing
Free
Free, no sign-up
Prices change. Check holiday.omikuji.dev before you buy.
World Public Holidays FAQ
How many countries are covered?
247 countries and regions.
Does it need sign-up?
No, it is free with no authentication.
What is the rate limit?
60 requests per minute per client.
What is the default country?
Japan, if none is given.
Is World Public Holidays free?
Yes. World Public Holidays is free to use.
How do I add World Public Holidays to Claude Code?
Run this command in your terminal: claude mcp add --transport http holiday https://holiday.omikuji.dev/mcp
What are the best alternatives to World Public Holidays?
The closest alternatives to World Public Holidays are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to World Public Holidays

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media