Command Palette

Search for a command to run...

UnylyUnyly
Browse all

bartosz-kuc/honest-pl-holidays-mcp

FreeNot checked

Polish public holidays and business-day math via the keyless Nager.Date API: listholidays, isholiday, isbusinessday, countbusinessdays, addbusinessdays and next

GitHubEmbed

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 year
  • is_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 dates
  • add_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.

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

from github.com/bartosz-kuc/honest-pl-holidays-mcp

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-mcp

FAQ

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

$5

Stripe

Payments, customers, subscriptions

Stripeby Stripe

malamutemayhem/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

malamutemayhemby malamutemayhem

whiteknightonhorse/APIbase

API hub covering travel (Amadeus, Sabre), Polymarket prediction markets, crypto and weather, paid per call via x402 in USDC.

whiteknightonhorseby whiteknightonhorse

trackerfitness729-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.

trackerfitness729-jpgby trackerfitness729-jpg

embeddedlayers/mcp-analytics

Statistical analysis, forecasting and ML on CSV files or live data from Shopify, Stripe, GA4 and more, with interactive HTML reports.

embeddedlayersby embeddedlayers

carrierone/verilexdata-mcp

Pay-per-query x402 datasets: NPI healthcare, SEC filings, OFAC sanctions, crypto whales, Polymarket signals, patents and economic indicators.

carrieroneby carrierone

paracetamol951/P-Link-MCP

HTTP 402 (Payment Required) implementation using Solana.

paracetamol951by paracetamol951

tipdotmd/tip-md-x402-mcp-server

Cryptocurrency tipping using the x402 payment protocol and CDP Wallet.

tipdotmdby tipdotmd

laundromatic/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

laundromaticby laundromatic

mrslbt/xendit-mcp

Xendit payment gateway for Southeast Asia: invoices, disbursements, balance checks and bank transfers.

mrslbtby mrslbt

Compare 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