📅

Get Country Holidays

Category: Holiday Tools

FULL HOLIDAY LIST: Get ALL holidays for a country in a specific year. Use this when user wants a complete list like 'What are all holidays in France 2024?' or 'List German holidays'. Returns every holiday with dates, names, and categories (PUBLIC=govt closures, BANK, SCHOOL, OPTIONAL). Can filter by categories using ?categories=public for govt closures only. NOT for checking a single date (use check_holiday) or multi-country (use check_multi_country_holiday). Fast: <30ms.

Parameters

country_codestringRequired

ISO 3166-1 alpha-2 country code (US, GB, JP, CN, IN, DE, FR, etc.)

yearnumberRequired

Year to get holidays for (e.g., 2024, 2025)

categoriesstringOptional

Optional: comma-separated categories to filter (e.g., 'public' for govt closures only, 'public,bank' for govt+bank holidays). If omitted, returns ALL categories.

Returns

country_code:Country code

year:Year

count:Total holidays

categories_requested:Categories included

holidays:Array of holidays with date, name, day_of_week, is_government_closure, categories

Example

get_country_holidays(country_code='US', year=2024)

Try It Now

This tool is available in the Vreme MCP server. Install via:

npx -y @vreme/temporal-mcp

Or add to your Claude Desktop, VS Code, Continue, or Cline configuration. See installation guide.