Skip to main content
Glama
io.github.mohammad-abbasi-sh/feiertage-mcp

io.github.mohammad-abbasi-sh/feiertage-mcp

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

feiertage_list_holidays

Public holidays of one year in one federal state (optional month filter)

feiertage_is_holiday

Is a date (YYYY-MM-DD) a public holiday in one state?

feiertage_next_holiday

The next public holiday on or after a date (looks into the next year)

feiertage_holidays_between

Public holidays in a date range (max ~2 years)

feiertage_list_states

All 16 federal states + NATIONAL (nationwide holidays)

feiertage_health

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 NATIONAL for the nationwide holidays (Neujahrstag, Karfreitag, Ostermontag, Tag der Arbeit, Christi Himmelfahrt, Pfingstmontag, Tag der Deutschen Einheit, 1./2. Weihnachtstag). Use feiertage_list_states for 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_between fetches one request per year in the range (max ~2 years).

Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Available Tools

6 tools
feiertage_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

    A4/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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