Skip to content
MCP server

Openholidays

MCP server giving AI clients public and school holiday data for about 30 European

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Openholidays

Openholidays is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.

The server exposes European holiday calendars through four tools: statutory public holidays, school term breaks, the list of covered countries, and regional subdivisions such as German federal states or Swiss cantons. Subdivision codes returned by one tool can be passed to the school holiday lookup to scope results to a specific region, which the README points to as the main difference from worldwide public-holiday sources.

The README says the endpoint is keyless for these lookups. Anonymous use is capped daily, and an optional Pipeworx API key raises the cap. The server can be connected as a remote streamable-HTTP endpoint or run locally via an npm stdio bridge that forwards calls to the same gateway.

The server suits developers and assistants that need to schedule, plan or answer questions about holidays in specific European regions. The listing notes that the connection also exposes shared gateway meta-tools alongside the four pack tools, and that the pack is an unofficial integration rather than one published by the upstream provider.

Install

Run in a terminal

claude mcp add --transport http openholidays https://gateway.pipeworx.io/openholidays/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/openholidays/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openholidays": {
      "url": "https://gateway.pipeworx.io/openholidays/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "openholidays": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openholidays/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openholidays": {
      "serverUrl": "https://gateway.pipeworx.io/openholidays/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openholidays": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/openholidays/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

public_holidays
Public (statutory) holidays for a European country in a date range, with regional subdivisions.
school_holidays
School holidays for a European country in a date range, optionally scoped to one subdivision.
list_countries
List the European countries covered, with ISO codes and official languages.
list_subdivisions
List regional subdivisions of a European country with their codes and category.

What it does

Public holiday lookup
Returns statutory holidays for a European country over a date range with localized names and dates.
School holiday lookup
Lists term breaks such as Christmas, Easter and summer, optionally scoped to one subdivision.
Country listing
Lists the roughly 30 covered European countries with ISO codes and official languages.
Regional subdivision listing
Returns federal states, regions or cantons with codes for use in school holiday queries.
Optional API key
Anonymous calls are daily-capped; a free Pipeworx key raises the limit.

Good for

  • Check which regions observe a public holiday before scheduling a cross-border meeting
  • Plan travel around school breaks in a specific German state or Swiss canton
  • Build a holiday calendar for a European team across several countries
  • Let an AI assistant answer questions about upcoming public or school holidays

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid credits and subscriptions beyond that.

Prices change. Check pipeworx.io before you buy.

Openholidays FAQ

Do the holiday tools need an API key?

The README says the four OpenHolidays tools are keyless. A Pipeworx API key is optional and only raises the daily call cap.

Which countries are covered?

The listing describes about 30 European countries, with examples including DE, FR, NL, CH, IT, AT, BE, ES and PL.

Does the endpoint list only the four holiday tools?

No. The README says tools/list also returns shared Pipeworx meta-tools such as ask_pipeworx, and the local npm bridge lists only pack tools unless PIPEWORX_META_TOOLS=1 is set.

Is Openholidays free?

Openholidays has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Openholidays to Claude Code?

Run this command in your terminal: claude mcp add --transport http openholidays https://gateway.pipeworx.io/openholidays/mcp

What are the best alternatives to Openholidays?

The closest alternatives to Openholidays are Public Holidays Mcp, Europe Rail Watch MCP, Paris Events, Montreal Events and Hasami-channel AI Paradise.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers