# World Public Holidays

> World Public Holidays is a free MCP server for productivity. Public holidays, business days and long weekends for 247 countries, as MCP tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://holiday.omikuji.dev/en/ai/
- **MCP Registry name:** dev.omikuji/holiday
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http holiday https://holiday.omikuji.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://holiday.omikuji.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "holiday": {
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "holiday": {
      "type": "http",
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "holiday": {
      "serverUrl": "https://holiday.omikuji.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "holiday": {
      "type": "http",
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/world-public-holidays
