Back to Browse

Feiertage MCP Server

Developer ToolsLow Risk8.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

8.3
Low Risk8.3Low Risk

Valid MCP server (1 strong, 4 medium validity signals). 4 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (42/44 approved). 1 finding(s) downgraded by scanner intelligence.

10 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub 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):

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

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

Reviews

No reviews yet

Be the first to review this server!