Taiwan Holiday

You can query Taiwan’s public holidays and workday patterns quickly and accurately using the Taiwan Holiday MCP Server. It follows the Model Context Protocol (MCP) and provides ready-made tools to check holidays, list holidays in a date range, and analyze holiday statistics for planning and AI-assisted workflows.

How to use

To use this MCP server with your MCP client, connect to a local or remote MCP endpoint that exposes holiday data via standard MCP tools. You can ask natural language questions like whether a date is a holiday, how many holidays occur in a given month, or what the longest holiday period in a year looks like. The server returns structured results including holiday descriptions, dates, and counts so your AI assistant can present clear answers and actionable recommendations.

How to install

Prerequisites you need installed on your machine before running the MCP server:

• Node.js 18 or newer

Follow these concrete steps to install and start the MCP server in multiple ways.

Quick start using NPX

npx taiwan-holiday-mcp

Local installation and run

npm install -g taiwan-holiday-mcp
 Taiuan-holiday-mcp

Development setup

git clone https://github.com/lis186/taiwan-holiday-mcp.git
cd taiwan-holiday-mcp
npm install
npm run build
npm start

Additional configuration examples

You can configure clients to connect to the MCP server in different environments. Below are exact JSON configuration examples you can adapt.

Claude Desktop configuration

{
  "mcpServers": {
    "taiwan-holiday": {
      "command": "npx",
      "args": ["taiwan-holiday-mcp"]
    }
  }
}

Cursor integration

Install the MCP integration button for Cursor to enable one-click setup with the Taiwan Holiday MCP Server.

[](https://cursor.com/install-mcp?name=taiwan-holiday&config=eyJjb21tYW5kIjoibnB4IHRhaXdhbi1ob2xpZGF5LW1jcCJ9)

Windsurf configuration

{
  "mcp": {
    "servers": {
      "taiwan-holiday": {
        "command": "npx",
        "args": ["taiwan-holiday-mcp"]
      }
    }
  }
}

Basic usage tips for AI assistants

Once connected, you can ask simple, natural questions such as: "Are there holidays on 2025-10-10?", "List holidays in January 2025", or "How many holidays are there in 2025?" The MCP server processes the queries and returns precise results that you can present to users or incorporate into planning tools.

Other important notes

This server provides standardized MCP endpoints for year-based holiday data and statistics, and it supports query patterns commonly used by AI assistants for planning and automation.

Available tools

check_holiday

Checks if a specific date is a Taiwan holiday and returns whether it is a holiday, its description, and the weekday.

get_holidays_in_range

Retrieves all Taiwan holidays within a given start and end date range, including totals and summaries.

get_holiday_stats

Provides holiday statistics for a given year or month, including total holidays and breakdowns by type.

taiwan_holidays_resources

MCP resources exposing years, holidays by year, and stats by year for querying.