Skip to content
MCP server

World Public Holidays

Public holidays, business days and long weekends for 247 countries, as MCP tools

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://holiday.omikuji.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

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

  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