Feiertage — German public holidays by year & federal state

io.github.mohammad-abbasi-shPublished by GitHub account mohammad-abbasi-shv0.1.0Updated Nov 14, 2026

Unofficial read-only MCP server for German public holidays — by year & state, next holiday.

VerifiedSTDIODesktop onlyLocation & Lifestyle

Overview

AI-generated overview

Read-only MCP server that lets an assistant look up German public holidays by year and federal state, check dates, and find the next holiday.

What you can do
  • List public holidays for a year in one federal state, optionally filtered by month
  • Check whether a given date is a public holiday in a state or nationwide
  • Find the next public holiday on or after a date, and list holidays within a date range
  • List the 16 federal state codes plus the nationwide set, and check API reachability
When to use it
Useful when an assistant needs reliable German holiday dates for scheduling, deadline or opening-hours questions, or for planning around regional holidays in a specific Bundesland.
Requirements
Runs locally over stdio, typically via uvx or python -m from the PyPI package; needs Python with the mcp and httpx dependencies and internet access to the feiertage-api.de service. No key or login.
Before you install
Unofficial and not affiliated with feiertage-api.de or the bundesAPI project, so results should be verified for legal or official use. Read-only, but each query is sent to a third-party API; some entries are notes such as school-free days rather than statutory holidays.

Installation

In SourceWeft

  1. Open Feiertage — German public holidays by year & federal state in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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):

json
{  "mcpServers": {    "feiertage": {      "command": "uvx",      "args": ["feiertage-mcp==0.1.0"]    }  }}

Or run locally: python -m feiertage_mcp.server (needs mcp<2, httpx).

Tools

ToolDescription
feiertage_list_holidaysPublic holidays of one year in one federal state (optional month filter)
feiertage_is_holidayIs a date (YYYY-MM-DD) a public holiday in one state?
feiertage_next_holidayThe next public holiday on or after a date (looks into the next year)
feiertage_holidays_betweenPublic holidays in a date range (max ~2 years)
feiertage_list_statesAll 16 federal states + NATIONAL (nationwide holidays)
feiertage_healthReachability check (ok / blocked / error) — one polite request

Example output (feiertage_is_holiday / 2026-10-03, NATIONAL):

json
{"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

Source: README.md at commit c71caa1

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestNov 14, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts