@dennisk2025/public-holidays-finder

Public Holidays Finder MCP Server

Provides a list of upcoming public holidays for a given country code and year, using real-world data from the Nager.Date API (https://date.nager.at/).

Features

• Instantly find all public holidays for any ISO 3166-1 alpha-2 country code and year.
• Works fully offline via Claude Desktop integration (fetches holidays live from the network).
• No API key required. Free and open source.

Installation & Usage

One-time install (optional)

npm install -g @dennisk2025/public-holidays-finder

Or run directly at any time with NPX:

npx @dennisk2025/public-holidays-finder

Adding to Claude Desktop

To make this server available in Claude Desktop, add the following configuration to your claude_desktop_config.json file:

{
  "mcpServers": {
    "public-holidays": {
      "command": "npx",
      "args": ["@dennisk2025/public-holidays-finder"]
    }
  }
}

Location of your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

After saving the file, restart Claude Desktop for changes to take effect.

Available Tool(s)

get_public_holidays

• Description: Fetches upcoming public holidays for the specified country (by ISO country code) and year.
• Parameters:
  • countryCode (string): An ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE").
  • year (integer): The year to search for public holidays (e.g., 2024).

Example Usage

Params:

{
  "countryCode": "US",
  "year": 2024
}

Result:

• Returns a JSON array of public holiday objects as provided by the Nager.Date API. Each object contains: date, localName, name, countryCode, fixed, global, counties, launchYear, type, etc.

Example Request/Response

Request:

Tool: get_public_holidays
Params: { "countryCode": "DE", "year": 2024 }

Response:

{
  "holidays": [
    {
      "date": "2024-01-01",
      "localName": "Neujahr",
      "name": "New Year's Day",
      "countryCode": "DE",
      ...
    },
    ...
  ]
}

Error Handling

• Errors such as invalid codes, year out of range, or unavailable data will return a descriptive error message.

Full Tool List

get_public_holidays

• Input:
  • countryCode (string, ISO 3166-1 alpha-2, required)
  • year (integer, required)
• Returns:
  • { holidays: [ ... ] } array of public holiday objects as per https://date.nager.at/swagger/index.html (fields: date, localName, name, etc.)

Powered by the Model Context Protocol (MCP). Not affiliated with Nager.Date or OpenAI/Anthropic.