Skip to content
MCP server

World Business Calendar

Public holidays and business-day math for 200+ countries, offline and keyless

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About World Business Calendar

World Business Calendar is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-world-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-world-calendar"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licensed; free, no keys required

Prices change. Check okagent.kr before you buy.

World Business Calendar 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 to World Business Calendar

  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