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.
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.
- 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
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.
One command — npx taiwan-holiday-mcp
