# World Business Calendar

> World Business Calendar is an open-source MCP server for productivity. Public holidays and business-day math for 200+ countries, offline and keyless. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://okagent.kr/mcp
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/world-calendar
- **MCP Registry name:** io.github.groove79/mcp-world-calendar
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

Built to stop assistants from guessing dates, this server answers whether a given day is a working day in a given country and what date falls N business days away. It respects local weekends, such as Friday and Saturday in Saudi Arabia and Israel or Friday only in Iran, and includes observed and substitute holidays.

Holiday data comes from the open-source date-holidays library, with state and region coverage, while Korea uses the K-MCP Korean engine. It runs offline with no API keys, either through `npx` or as a hosted endpoint at okagent.kr. It is one package in the wider K-MCP collection and is MIT licensed.

## Features

- **Holiday lists by year:** Returns a country or region's holidays for a year with English and local names, marked public, bank or optional.
- **Business-day checks:** Says whether a date is a working day and finds the next or previous one.
- **Business-day arithmetic:** Adds or subtracts working days, or counts working days between two dates.
- **Cross-country overlap:** Finds dates that are working days in all of several countries.
- **Local weekend rules:** Applies country-specific weekends instead of assuming Saturday and Sunday.
- **Hosted option:** Can be used without installing through a Streamable HTTP endpoint or REST.

## Good for

- Scheduling a cross-border meeting on a day everyone is working
- Estimating settlement or delivery dates in business days
- Checking whether a date is a public holiday in a given country
- Listing a year's holidays for a region for planning

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-world-calendar -- npx -y @appmonster/mcp-world-calendar
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-world-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
```

## Tools

- `world_list_holidays`: Holidays of a country or region for a year
- `world_is_business_day`: Checks working day status and finds next or previous working day
- `world_add_business_days`: Adds or subtracts working days or counts them between dates
- `world_common_business_days`: Dates that are working days in several countries
- `world_list_countries`: Supported country and region codes

## FAQ

### Does it need an API key?

No. The README describes it as offline and keyless.

### How many countries does it cover?

More than 200 countries and their states or regions.

### Can I use it without installing anything?

Yes. A hosted Streamable HTTP endpoint at okagent.kr/api/mcp and a REST endpoint are listed.

### Where does the holiday data come from?

The date-holidays library, with holiday data under CC-BY-3.0; Korea uses the K-MCP engine.

### Is World Business Calendar free?

Yes. World Business Calendar is open source, so you can use and self-host it for free.

### How do I add World Business Calendar to Claude Code?

Run this command in your terminal: claude mcp add mcp-world-calendar -- npx -y @appmonster/mcp-world-calendar

### What are the best alternatives to World Business Calendar?

The closest alternatives to World Business Calendar 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-business-calendar
