io.github.mohammad-abbasi-sh/feiertage-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., "@io.github.mohammad-abbasi-sh/feiertage-mcp List the German public holidays in Bavaria for 2025"
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.
feiertage-mcp 📅
mcp-name: io.github.mohammad-abbasi-sh/feiertage-mcp
Unofficial read-only MCP server for German public holidays (gesetzliche Feiertage) via the feiertage-api.de API (bundesAPI project): holidays per year and federal state, is-it-a-holiday checks, the next holiday from a date, and holidays in a date range. No key, no login.
Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with feiertage-api.de / the bundesAPI project.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"feiertage": {
"command": "uvx",
"args": ["feiertage-mcp==0.1.0"]
}
}
}Or run locally: python -m feiertage_mcp.server (needs mcp<2, httpx).
Related MCP server: holidays-mcp
Tools
Tool | Description |
| Public holidays of one year in one federal state (optional month filter) |
| Is a date (YYYY-MM-DD) a public holiday in one state? |
| The next public holiday on or after a date (looks into the next year) |
| Public holidays in a date range (max ~2 years) |
| All 16 federal states + NATIONAL (nationwide holidays) |
| Reachability check (ok / blocked / error) — one polite request |
Example output (feiertage_is_holiday / 2026-10-03, NATIONAL):
{"date": "2026-10-03", "weekday": "Saturday", "weekday_de": "Samstag",
"state": "NATIONAL", "is_holiday": true,
"holidays": ["Tag der Deutschen Einheit"],
"details": [{"name": "Tag der Deutschen Einheit", "date": "2026-10-03",
"note": null, "note_only": false, "weekday": "Saturday",
"weekday_de": "Samstag"}]}Notes:
State codes are the 2-letter codes: BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH — or
NATIONALfor the nationwide holidays (Neujahrstag, Karfreitag, Ostermontag, Tag der Arbeit, Christi Himmelfahrt, Pfingstmontag, Tag der Deutschen Einheit, 1./2. Weihnachtstag). Usefeiertage_list_statesfor the full list.Holiday names are German; each dated holiday also carries its weekday in English and German.
A few entries have no date (
note_only: true) — they are notes, e.g. school-free days, not statutory public holidays. Date-based tools skip them.Years 1900–2100 are accepted; the API serves historical and future calendars.
feiertage_holidays_betweenfetches one request per year in the range (max ~2 years).
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Available Tools
6 toolsfeiertage_healthA
Check whether the feiertage-api.de API is reachable right now.
Returns status ok (HTTP 200), blocked (HTTP 403/429 — bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings.
Inputs: no named parameters. Returns: result
feiertage_holidays_betweenA
Public holidays in a date range in one German federal state. start_date / end_date: YYYY-MM-DD (max range ~2 years). state: 2-letter code or NATIONAL (default NATIONAL).
Inputs: end_date (required), start_date (required), state. Returns: result
feiertage_is_holidayA
Is a date a public holiday in one German federal state? day: YYYY-MM-DD, e.g. 2026-12-25. state: 2-letter code or NATIONAL (default NATIONAL). Returns is_holiday plus the holiday name(s).
Inputs: day (required), state. Returns: result
feiertage_list_holidaysA
List the public holidays of one year in one German federal state. year: e.g. 2026 (default: current year). state: 2-letter code (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH) or NATIONAL for the nationwide holidays (default NATIONAL). month: 1..12 to filter to one month (default: whole year). Entries with date null (note_only) are notes, not statutory holidays.
Inputs: year, month, state. Returns: result
feiertage_list_statesA
All 16 German federal states (Bundesländer) plus NATIONAL (nationwide holidays) — the state codes the other tools accept.
Inputs: no named parameters. Returns: result
feiertage_next_holidayA
The next public holiday on or after a date in one German state. from_date: YYYY-MM-DD (default: today). state: 2-letter code or NATIONAL (default NATIONAL). Looks into the next year if the current year has no holiday left.
Inputs: state, from_date. Returns: result
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 clearly distinct query shape: year/month listing, single-date check, next-holiday lookup, date-range scan, state code reference, and health probe. The only mild overlap is between feiertage_list_holidays with a month filter and feiertage_holidays_between, which can return similar data, but the descriptions make the intended use of each clear.
All six tools use the same feiertage_ prefix followed by a consistent verb_noun snake_case pattern (list_holidays, is_holiday, next_holiday, holidays_between, list_states, health). The convention is predictable and readable throughout.
Six tools is a well-scoped set for a read-only holiday lookup service; every tool maps to a distinct query need (listing, checking, upcoming, range, state codes, availability). No filler or redundant endpoints.
The surface covers the full read-only lifecycle: discovering valid state codes, listing holidays, checking a date, finding the next one, scanning ranges, and probing API health. Minor gap: no tool to resolve a holiday name back to dates or to return holiday metadata beyond name/date, but agents can work around this via the listing tools.
Related MCP Connectors
Plan vacation days around public holidays, bridge days and school holidays in DE, AT and CH
Free, keyless public holidays lookup for any country and year, plus single-date holiday checks.
Public holiday data for 30+ countries. Check holidays, working days and calendars via AI assistants.
Public holidays of about 200 countries: next holidays, is a given date a holiday. Free, no key.
Related MCP Servers
- 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
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to look up public and school holidays across roughly 30 European countries for any date range, including localized holiday names, nationwide status, and regional subdivision coverage. Also lists covered countries and their subdivisions so school-term queries can be scoped to a specific region.89 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to query German public holidays by Bundesland and school holidays, check whether dates are holidays, find upcoming holidays, and count working days using offline, sourced data.MIT