pl-holidays-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pl-holidays-mcp Add 14 business days to 2026-07-22"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
honest-pl-holidays-mcp
Local MCP server for Polish public holidays and business-day arithmetic. Wraps the open Nager.Date holiday database and adds bookkeeping-friendly business-day math on top.
Part of the honest-mcp family of small, auditable, local-first MCP servers.
Why
Every Polish accountant, JDG owner, or HR person has this problem:
"Payment term is 14 dni roboczych from invoice date — what's the actual due date?"
"Is the client's 'termin płatności 2026-05-01' even a business day? (No — that's Święto Pracy.)"
"Deadline for JPK_V7 is the 25th — but 2026-04-25 is a Saturday, does it slip to Monday?"
This server hands both raw holiday data and business-day arithmetic to your AI. No more spreadsheet calendars.
Supports any country Nager.Date covers (200+), but the API defaults to Poland and the bookkeeping angle is Poland-centric.
Weekend caveat: the weekend is always Saturday + Sunday, whatever country you pass — only the holiday list changes per country. Business-day results for countries with a different weekend (e.g. Friday–Saturday in Egypt) will be wrong.
Related MCP server: bizdays
Features
Six tools:
list_holidays— all public holidays in a given yearis_holiday— is this specific date a public holiday?is_business_day— is this date Mon–Fri and not a holiday? Includes reason (weekend / holiday / business_day)count_business_days— inclusive business-day count between two datesadd_business_days— start_date + N business days = ? (N can be negative)next_holidays— upcoming N holidays from a given date
Data source
Endpoint: date.nager.at/api/v3
No API key
MIT-licensed holiday data
In-memory cache per year and country — normally one round trip per year and country per session
Requirements
Python 3.10+
Setup
git clone https://github.com/bartosz-kuc/honest-pl-holidays-mcp.git
cd honest-pl-holidays-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txtOn Windows, use venv\Scripts\pip and venv\Scripts\python instead of venv/bin/pip and venv/bin/python (here and in the configs below).
Register with Claude Code:
claude mcp add pl-holidays /absolute/path/to/venv/bin/python /absolute/path/to/server.pyClaude Desktop claude_desktop_config.json:
{
"mcpServers": {
"pl-holidays": {
"command": "/absolute/path/to/venv/bin/python",
"args": ["/absolute/path/to/server.py"]
}
}
}Example usage
"Invoice issued today with 14 working-day payment term — when is it due?"
add_business_days(start_date="2026-07-22", days=14) → the due date, skipping weekends and Polish public holidays.
"How many working days between 2026-04-01 and 2026-04-30?"
count_business_days(from_date="2026-04-01", to_date="2026-04-30")
"Is May 1st 2026 a business day in Poland?"
is_business_day(date="2026-05-01") → false, reason: holiday (Święto Pracy).
Data flow
Your AI client
↕ MCP stdio
This server (Python, on your machine)
↕ HTTPS
date.nager.at (Nager.Date open holiday DB)No cloud middle for anything but the initial holiday-date fetch. No telemetry.
Author
Bartosz Kuć — Warsaw-based developer, JDG owner running skanfirmy.pl.
GitHub: https://github.com/bartosz-kuc
Email: firma@bartosza.pl
Consulting
Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams. See skanfirmy.pl/uslugi for productized packages (audit 3k PLN, setup 8-15k PLN, retainer 2-4k PLN/mo), or reach out via email.
License
MIT — see LICENSE.
Related
Part of the honest-mcp family — see the family index.
Available Tools
6 toolsadd_business_daysA
Add N business days to a start date and return the resulting date. N can be negative to subtract. Skips weekends and Polish public holidays. If start_date is itself a non-business day, counting starts from the next business day (the previous one when N is negative). The weekend is always Saturday + Sunday, whatever country is passed; only the holiday list changes per country.
Inputs: days (required), start_date (required), country.
count_business_daysA
Count business days between two dates (inclusive), skipping weekends and Polish public holidays. Useful for enforcing '14-dni-roboczych' style payment terms. The weekend is always Saturday + Sunday, whatever country is passed; only the holiday list changes per country.
Inputs: to_date (required), from_date (required), country.
is_business_dayA
Check whether a date is a Polish business day — Monday–Friday and not a public holiday. Returns the answer plus the reason (weekend / holiday / business_day). The weekend is always Saturday + Sunday, whatever country is passed; only the holiday list changes per country, so results are wrong for countries with a different weekend.
Inputs: date (required), country.
is_holidayA
Check whether a specific date is a public holiday in Poland. Returns holiday details if yes, null if no.
Inputs: date (required), country.
list_holidaysA
List all Polish public holidays in a given year. Each holiday has date, localName (Polish name), name (English name), and type. Defaults to Poland but supports any ISO 3166-1 alpha-2 country code.
Inputs: year (required), country.
next_holidaysB
Get the upcoming public holidays (default: next 5) from a given date. Handy for planning around long weekends.
Inputs: count, country, from_date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear, distinct purpose: listing holidays, checking a single date, checking business-day status, counting business days, adding business days, and fetching upcoming holidays. Even list_holidays and next_holidays are clearly separated by temporal scope.
Most tools follow a clear verb_noun snake_case pattern: list_holidays, is_holiday, is_business_day, count_business_days, add_business_days. next_holidays is a minor deviation from the verb-first pattern, but it remains predictable and readable.
Six tools is a well-scoped size for a Polish holidays and business-day server. Each tool covers a meaningful operation without redundancy or unnecessary bloat.
The tool set covers the full domain: holiday enumeration, date checking, business-day determination, business-day counting, and business-day arithmetic. No significant gaps exist for the stated Polish holiday/business-day purpose.
Related MCP Connectors
Count days between dates, add or subtract dates, and look up public holidays by country.
Public holidays for 150+ countries, business-day maths and timezone lookup
Holidays MCP — wraps Nager.Date API (free, no auth)
Public holiday data for 30+ countries. Check holidays, working days and calendars via AI assistants.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to the Nager.Date Public Holiday API for querying global holiday information through the Model Context Protocol. It enables AI agents to interact with standardized tools for holiday-related date calculations and country-specific lookups.-
- AlicenseAqualityCmaintenanceProvides deterministic business-day calculations for AI agents, correctly handling country-specific weekends and public holidays.643 npm1Apache 2.0
- AlicenseNot gradedqualityBmaintenanceProvides public holidays, long weekends, and country data for 202 countries via the Nager.Date API, with client-side filtering and timezone-aware checks.1BSD Zero Clause
- AlicenseAqualityDmaintenanceProvides real, official public holiday data for ~100 countries with tools to list holidays for a year and check if a specific date is a holiday. Free, no API key required, powered by Nager.Date.2MIT