World Public Holidays

dev.omikujiPublished by omikuji.devOfficial publisherv1.2.0Updated Oct 30, 2026

Public holidays, business days and long weekends for about 250 countries, in each local time zone.

The publisher's own server: Japan Restaurant Calories

VerifiedStreamable HTTPWeb executableLocation & LifestyleProductivity & Workflow

Overview

AI-generated overview

Remote MCP server that lets an assistant check public holidays, business days and long weekends for about 250 countries in local time zones.

What you can do
  • Check dates: say whether each date is a public holiday, weekend or business day, with holiday name, status and today's date in the country's time zone
  • List holidays: show a country's public holidays for a year or a date range, or the next 10 upcoming holidays
  • Count business days: count business days between two dates or find the date N business days after a start date, using local weekends, holidays and make-up working days
  • Find long weekends: list runs of 3 or more consecutive days off, such as Japan's Golden Week or China's National Day Golden Week
When to use it
Useful when scheduling, planning deadlines, deliveries or travel around holidays, or when an assistant needs to know whether a given date is a working day in a specific country.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. Country is given as an ISO 3166-1 alpha-2 code and defaults to JP when omitted.
Before you install
Data covers roughly last year to two years ahead; holidays marked estimated are not yet announced or depend on moon sighting, and unannounced Japanese years are reported as unknown. Days off limited to government offices are listed but not counted unless include_government is set, so business-day counts can differ from local practice.

Installation

In SourceWeft

  1. Open World Public Holidays in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.omikuji%2Fholiday/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "world-public-holidays": {
      "type": "http",
      "url": "https://holiday.omikuji.dev/mcp"
    }
  }
}

Tools

4

check_dates

Check dates

For each date, tell whether it is a public holiday in the country (with its name and status), a weekend, and a business day, including make-up working days such as China's 调休. Also returns today in that country's time zone. For Japan, the kind is also given: 祝日 (national holiday) / 振替休日 (substitute holiday) / 国民の休日 (citizens' holiday).

Parametersdatesrequiredregioncountryyear_end_closedinclude_government

list_holidays

List holidays

List a country's public holidays for a year, or between from and to (and make-up working days, if any). With no year or range, lists the next 10 holidays from today in that country.

Parameterstofromyearlimitregioncountryinclude_government

business_days

Business days

Count business days between start and end (inclusive), or find the date that is N business days after start (add=N; negative N goes backward; start itself is not counted). Uses the country's weekend days, public holidays and make-up working days. For Japan, set year_end_closed to also skip 12/29-1/3.

Parametersaddendstartrequiredregioncountryyear_end_closedinclude_government

find_long_weekends

Find long weekends

Find long weekends: 3+ consecutive days off made of weekends and public holidays in the country (e.g. Japan's Golden Week, China's National Day Golden Week). Give a year, or from (default today) to list upcoming ones.

Parametersfromyearlimitregioncountrymin_lengthinclude_government

Version history

3
  1. v1.2.0LatestOct 30, 2026
  2. v1.1.0Oct 15, 2026
  3. v1.0.0Oct 15, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Omikuji integrations

Japan Restaurant Calories

dev.omikujiOfficial publisher

Remote MCP server that lets an assistant look up nutrition facts for Japanese restaurant chain menu items and packaged foods, and total them up.

Streamable HTTPWeb executable
Location & Lifestyle4 toolsOct 24, 2026

Shiritori Dictionary (Japanese)

dev.omikujiOfficial publisher

Lets an assistant play Japanese shiritori by checking moves against a 90,000-word dictionary and suggesting valid next words.

Streamable HTTPWeb executable
3 toolsOct 24, 2026

Traditional Colors

dev.omikujiOfficial publisher

Lets an assistant look up traditional color names across Japanese and 10 other cultures, returning hex/RGB values with sources and finding the nearest named hue

Streamable HTTPWeb executable
Knowledge & Memory4 toolsOct 24, 2026

Manekami — digital shrine & omikuji

Published by GitHub account dio6742

A remote digital shrine that offers omens, lamps, lanterns, and AI pilgrim notes for algorithm anxiety.

Streamable HTTPWeb executable
5 toolsOct 24, 2026