Labsco
MCP SERVER

Taiwan Holiday

by lis186

Check whether a Taiwan date is a public holiday, list the holidays in a range, or count a whole year's.

Time, Dates & CalculationVerified
Summary
Taiwan's holiday calendar, including the make-up workdays that break naive planning.

Taiwan's calendar has a feature most holiday lookups do not model: compensatory workdays, where a Saturday becomes a working day to bridge a long weekend. The statistics separate those from national holidays, and the range query returns the actual span, which is what makes "which long weekends fall in the first quarter" answerable rather than estimated. Data follows the government's announcements through the TaiwanCalendar project, so anything with legal or contractual weight is worth confirming at the official source.

What it is

A holiday lookup for Taiwan built on the TaiwanCalendar dataset, which tracks the government's announced national holidays and make-up workdays. Ask about a single date, a date range, or a year.

What you get
  • Whether one date is a holiday, with the holiday's name, the weekday, and a normalised form of the date
  • Every holiday between two dates, with a count and a written summary of the period
  • Statistics for a year or a single month, with national holidays and compensatory workdays counted separately
  • Both YYYY-MM-DD and YYYYMMDD accepted, so what the user typed does not need reformatting first
  • Resources as well as tools: the supported years, a year's full holiday data, and a year's statistics
Requirements

Node.js 18.0.0 or newer, launched with npx taiwan-holiday-mcp over stdio. Nothing to authorize. Holiday data comes from the TaiwanCalendar project and is cached after the first fetch, so the first query needs network access. Coverage starts at 2017 and its upper end follows the upstream dataset, which picks up each new year as it is published.

Setup effort

One command — npx taiwan-holiday-mcp