
Openholidays
MCP server giving AI clients public and school holiday data for about 30 European
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/openholidays/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"openholidays": {
"url": "https://gateway.pipeworx.io/openholidays/mcp"
}
}
}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.