check_holiday
Checks whether a given date is a Taiwan holiday
LABSCO 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
USE CASES
01
Checking whether next Monday is a working day
Ask about the single date and get the holiday name and weekday back, in whichever date format you already have.
02
Planning leave around the long weekends
Pull every holiday in a date range with its count and summary, then look for the runs.
03
Scheduling a release that must not land on a holiday
Check each candidate date before you commit the calendar invite.
04
Working out which month carries the most time off
Read the year's statistics, or narrow to one month, with national holidays and make-up days counted apart.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_holiday_stats
Returns Taiwan holiday statistics for a year, or for a single month within it
get_holidays_in_range
Returns every Taiwan holiday falling between a start date and an end date
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
- npx on PATH
- Node.js 18.0.0 or later
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx taiwan-holiday-mcpMCP Clients
Claude Desktop, Windsurf
JSON
{
"mcpServers": {
"taiwan-holiday": {
"command": "npx",
"args": [
"taiwan-holiday-mcp"
]
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"taiwan-holiday-mcp": {
"command": "npx taiwan-holiday-mcp"
}
}
}
