bartosz-kuc/honest-pl-holidays-mcp
FreeNot checkedPolish public holidays and business-day math via the keyless Nager.Date API: listholidays, isholiday, isbusinessday, countbusinessdays, addbusinessdays and next
About
Polish public holidays and business-day math via the keyless Nager.Date API: listholidays, isholiday, isbusinessday, countbusinessdays, addbusinessdays and nextholidays, e.g. for working-day invoice payment terms. Defaults to Poland; country takes other ISO codes.
README
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.
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.txt
On 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.py
Claude 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: [email protected]
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.
Installing bartosz-kuc/honest-pl-holidays-mcp
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/bartosz-kuc/honest-pl-holidays-mcpFAQ
Is bartosz-kuc/honest-pl-holidays-mcp MCP free?
Yes, bartosz-kuc/honest-pl-holidays-mcp MCP is free — one-click install via Unyly at no cost.
Does bartosz-kuc/honest-pl-holidays-mcp need an API key?
No, bartosz-kuc/honest-pl-holidays-mcp runs without API keys or environment variables.
Is bartosz-kuc/honest-pl-holidays-mcp hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install bartosz-kuc/honest-pl-holidays-mcp in Claude Desktop, Claude Code or Cursor?
Open bartosz-kuc/honest-pl-holidays-mcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Stripe
Payments, customers, subscriptions
by Stripemalamutemayhem/unclick-agent-native-endpoints
110+ tools for AI agents spanning social media, finance, gaming, music, AU-specific services, and utilities. Zero-config local tools plus platform connectors. n
by malamutemayhemwhiteknightonhorse/APIbase
API hub covering travel (Amadeus, Sabre), Polymarket prediction markets, crypto and weather, paid per call via x402 in USDC.
by whiteknightonhorsetrackerfitness729-jpg/sitelauncher-mcp-server
Deploy live HTTPS websites on subdomains or custom .xyz domains, paid in USDC on Base, with templates for crypto tokens and AI agent profiles.
embeddedlayers/mcp-analytics
Statistical analysis, forecasting and ML on CSV files or live data from Shopify, Stripe, GA4 and more, with interactive HTML reports.
by embeddedlayerscarrierone/verilexdata-mcp
Pay-per-query x402 datasets: NPI healthcare, SEC filings, OFAC sanctions, crypto whales, Polymarket signals, patents and economic indicators.
by carrieroneparacetamol951/P-Link-MCP
HTTP 402 (Payment Required) implementation using Solana.
by paracetamol951tipdotmd/tip-md-x402-mcp-server
Cryptocurrency tipping using the x402 payment protocol and CDP Wallet.
by tipdotmdlaundromatic/shopgraph
Structured product data from the open web — Schema.org + AI extraction for e-commerce enrichment. Pay per call via Stripe. [shopgraph.dev](https://shopgraph.dev
by laundromaticmrslbt/xendit-mcp
Xendit payment gateway for Southeast Asia: invoices, disbursements, balance checks and bank transfers.
by mrslbtCompare bartosz-kuc/honest-pl-holidays-mcp with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All finance MCPs
