What it does
Swiss school & public holidays, 26 cantons, by Schulart (OpenHolidays + Nager.Date)
- Connects Läuft auf deinem Computer
- Account or key No key needed
- Category Spiele, Sport, Essen & Lernen
Warum es hier steht
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 0/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 12/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Swiss Holidays MCP. Folge https://mcp.popnx.com/i/malkreide-swiss-holidays-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Von der KI installieren lassen
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Swiss Holidays MCP für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "swiss-holidays": { "command": "uvx", "args": [ "swiss-holidays-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Swiss Holidays MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Einstellungsdatei der Claude-Desktop-App öffnen
SettingsDeveloperEdit Config
Diese Einstellungen einfügen und speichern
{ "mcpServers": { "swiss-holidays": { "command": "uvx", "args": [ "swiss-holidays-mcp" ] } } }Claude beenden und neu öffnen
Ausprobieren
Nutze Swiss Holidays MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Swiss Holidays MCP nutzt, oder ein Werkzeug von Swiss Holidays MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Swiss Holidays MCP noch nicht verbinden
Swiss Holidays MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
Das kannst du stattdessen tun
A · Eine App nutzen, die Swiss Holidays MCP verbinden kann
- Installiere zuerst Python (uv) auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
- Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
- Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
- Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
B · Andere in Spiele, Sport, Essen & Lernen, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
- ShipSwift✓ ChatGPT
- Anime Garden✓ ChatGPT
- Summer Engine✓ ChatGPT
Klappt mit Claude Code, aber erst etwas vorbereiten
Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Swiss Holidays MCP für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user swiss-holidays -- uvx swiss-holidays-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Swiss Holidays MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --scope user swiss-holidays -- uvx swiss-holidays-mcp/mcp in Claude Code eingeben
Swiss Holidays MCP sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze Swiss Holidays MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Swiss Holidays MCP nutzt, oder ein Werkzeug von Swiss Holidays MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Swiss Holidays MCP für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "swiss-holidays": { "command": "uvx", "args": [ "swiss-holidays-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Swiss Holidays MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze Swiss Holidays MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Swiss Holidays MCP nutzt, oder ein Werkzeug von Swiss Holidays MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Installiere zuerst Python (uv) auf deinem Computer (nur einmal)
Von der KI installieren lassen
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Swiss Holidays MCP für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe uv mit uv --version. Fehlt es, sag mir, dass ich es von https://docs.astral.sh/uv/getting-started/installation/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "swiss-holidays": { "type": "stdio", "command": "uvx", "args": [ "swiss-holidays-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Swiss Holidays MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
uv installieren (falls noch nicht vorhanden)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
uv --version- Eine Versionsnummer wie uv … = installiert, diesen Schritt überspringen
- "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
So öffnest du das Terminal
Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: uv hat keinen Klick-Installer. Kopiere den Einzeiler für dein System (macOS oder Windows) von der offiziellen uv-Seite ins Terminal · Python muss nicht extra installiert werden, uv lädt es bei Bedarf selbst
Download-Seite von uv öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen:
uv --versionEinmal installieren, gilt für alles, was uv braucht
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze Swiss Holidays MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Swiss Holidays MCP nutzt, oder ein Werkzeug von Swiss Holidays MCP in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Auf deinem Computer installiert
Claude Code
claude mcp add --scope user swiss-holidays -- uvx swiss-holidays-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"swiss-holidays": {
"command": "uvx",
"args": [
"swiss-holidays-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"swiss-holidays": {
"command": "uvx",
"args": [
"swiss-holidays-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"swiss-holidays": {
"type": "stdio",
"command": "uvx",
"args": [
"swiss-holidays-mcp"
]
}
}
}Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
- Downloads pro Wochei
- 22/Wo.
- Verbindung
- Läuft auf deinem Computer
- Neueste Versioni
- 0.7.0
- Kategoriei
- Spiele, Sport, Essen & Lernen
- In der Registry veröffentlichti
- 27. Sept. 2026
- Code zuletzt geänderti
- 1. Nov. 2026
- Entwickler
- malkreide
- Pakete
pypi: swiss-holidays-mcp- Website
- github.com
- Registry-Status
- Aktiv
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto malkreide bestätigt, dem das Repo gehört
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 18 Tagen
- ✓ Bestanden
Hat eine Lizenz
Nutzt MIT
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Veröffentlichte Schwachstellen (OSV.dev)
Keine Einträge auf OSV.dev für swiss-holidays-mcp@0.7.0
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/malkreide-swiss-holidays-mcp)Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni
- Mehr Sterne als 0 % der anderen 1611 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 29 % der anderen 1611 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 99 % der anderen 1611 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Swiss Holidays MCP sicher?
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vor 18 Tagen geändert, und die neueste Version (0.7.0) kam vor 2 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Ähnliche Alternativen
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| Dieser Swiss Holidays MCP | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Nein | Nein | Nein | Ja | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| Lizenz | MIT | AGPL-3.0 | MIT | MIT | Apache-2.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide)
This is a private project. It is independent of any employer or institutional affiliation and represents no official position of any authority.
📅 swiss-holidays-mcp
A Swiss holiday calendar for AI agents — public holidays, school holidays and long weekends for all 26 cantons, with cross-cantonal comparison. School holidays are differentiated by *Schulart* (school type), which matters more than it first appears. No API key required.
Overview
swiss-holidays-mcp is a Swiss holiday calendar for AI assistants like Claude — public holidays, school holidays and long weekends for all 26 cantons, no API keys required. Public holidays are cantonal (Berchtoldstag, Fronleichnam & co. differ by canton, not just the federal minimum). School holidays are set cantonally, sometimes at district level, and — in six cantons — separately per school type. A single federal calendar does not exist; anyone planning across cantonal borders is otherwise reduced to opening 26 PDF pages.
The server covers two thematic clusters: public holidays / long weekends and school holidays (with *Schulart* differentiation). Each cluster maps to a group of purpose-built tools that translate raw agency data into clean, provenance-tagged JSON responses. All data comes from the OpenHolidays API (CC BY 4.0) and Nager.Date (MIT).
Mnemonic: *A duplicate in Swiss school data is usually a school type in disguise.* The underlying API publishes the *same* holiday period several times when a canton differentiates by school type. That looks like duplicated data and invites naive de-duplication — which would destroy exactly the distinction a school authority needs.
Anchor demo query: *"In which weeks of 2026 are the compulsory schools of Zurich, Zug and Aargau simultaneously on holiday — and how many overlapping days does each pair share?"* → This exercises find_common_free_window, compare_school_holidays and list_school_types in a single conversation, and answers a question that recurs every planning cycle in inter-cantonal coordination. → More use cases by audience →
Demo
Features
- 🏫 School holidays — periods per canton and date range, differentiated by *Schulart* (
VS/MS/BS/EO) - 🎌 Public holidays — cantonal holiday sets, not just the federal minimum (Berchtoldstag & friends)
- 🔍 Date check — is a given date a school or public holiday in a canton?
- 🔗 Cross-cantonal comparison — pairwise overlap matrix of holiday days between cantons
- 🪟 Common free windows — date ranges where all listed cantons are simultaneously on holiday
- 🌉 Long weekends & bridge days — computed from federal public holidays (Nager.Date)
- 🏘️ Local & municipal holidays — district- and municipality-level specifics such as Zurich's Sechseläuten and Knabenschiessen, with a
scopemarker so they are never mistaken for canton-wide - 📆 iCal / ICS export — a canton's holidays for a year as a ready-to-import
.icscalendar - 🔖 Holiday feed resource —
holidays:// /MCP resource with a Markdown summary - 📌 "Is today a holiday?" — one-call convenience for the everyday question
- 🩺 Source health — reachability and latency of both upstreams, always evaluable
- 🔑 No authentication required — both data sources are publicly accessible
- ☁️ Dual transport — stdio for Claude Desktop, Streamable HTTP/SSE for cloud deployment
- 🧾 Provenance on every response —
live_api|cached|degraded, never a silent empty list
Data Sources
| Source | Data | Licence |
|---|---|---|
| OpenHolidays API | Cantons, *Schularten*, school holidays, public holidays | CC BY 4.0 |
| Nager.Date | Long weekends and required bridge days | MIT |
Both sources are publicly accessible, no authentication required. Attribution required: OpenHolidays (CC BY 4.0) and Nager.Date must be cited as the source when using their data.
Tools
| Tool | Purpose | Data Source |
|---|---|---|
list_cantons | The 26 cantons with ISO codes and official languages | OpenHolidays |
list_school_types | *Schulart* groups per canton (CH-ZH-VS etc.) | OpenHolidays |
get_school_holidays | School holidays for one canton and date range | OpenHolidays |
get_public_holidays | Public holidays for one canton and year | OpenHolidays |
get_local_holidays | Public holidays for one municipality or district, incl. local specifics | OpenHolidays |
check_date | Is a given date a school or public holiday? | OpenHolidays |
compare_school_holidays | Pairwise overlap matrix across cantons | OpenHolidays |
find_common_free_window | Windows where all listed cantons are on holiday | OpenHolidays |
next_school_holidays | The next upcoming holiday periods | OpenHolidays |
get_long_weekends | Long weekends and required bridge days | Nager.Date |
export_holidays_ics | A canton's holidays for a year as an iCalendar (.ics) document | OpenHolidays |
is_holiday_today | Is today a school or public holiday in a canton? | OpenHolidays |
source_status | Reachability and latency of both upstreams | Built-in |
Resources
| Resource URI | Content |
|---|---|
holidays://{canton}/{year} | Markdown summary of all public + school holidays, e.g. holidays://CH-ZH/2026 |
All tools carry the full annotation set — readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true (they reach an external API). No tool writes anywhere. Inputs are schema-validated (canton codes against the 26 known cantons, dates as YYYY-MM-DD, year bounded, language/school_type whitelisted).
Example Use Cases
| Query | Tool |
|---|---|
| *"Which cantons are there, and what are their codes?"* | list_cantons |
| *"Show Zurich's compulsory-school holidays for spring 2026"* | get_school_holidays |
| *"Is 3 April 2026 a public holiday in Ticino?"* | check_date |
| *"Do Zurich and Zug school holidays overlap this year?"* | compare_school_holidays |
| *"When can all of ZH, ZG, AG plan a joint week off school?"* | find_common_free_window |
| *"What are the next holidays for Basel-Stadt schools?"* | next_school_holidays |
| *"Which long weekends does 2026 have, and which bridge days do they need?"* | get_long_weekends |
| *"Which local holidays does the city of Zurich keep that the rest of the canton doesn't?"* | get_local_holidays |
| *"Export Zurich's 2026 holidays as an .ics calendar I can import"* | export_holidays_ics |
| *"Is today a holiday in Aargau?"* | is_holiday_today |
🛡️ Safety & Limits
| Aspect | Details |
|---|---|
| Access | Read-only (readOnlyHint: true) — the server cannot modify or delete any data |
| Personal data | No personal data — all sources are aggregated, public holiday calendars |
| Caching | 12-hour in-memory TTL (holiday tables change a handful of times per year) |
| Retry | Exponential backoff 2s / 4s / 8s; 4xx except 429 are not retried |
| Timeout | 20 seconds per API call (8 seconds for health probes) |
| Authentication | No API keys required — both upstreams are publicly accessible |
| Degradation | Upstream failure yields a degraded envelope with an explanatory note, never a silent empty list |
| Terms of Service | Subject to the ToS of the respective data sources: OpenHolidays, Nager.Date |
Architecture
This server uses Architecture A (live API only, with in-memory cache).
┌──────────────────────────┐
Claude / any ───▶│ swiss-holidays-mcp │ MCP host │ (MCPServer · 13 tools) │ └────────┬─────────────────┘ │ retry 2s/4s/8s · 12h cache ┌────────┴─────────┐ ▼ ▼ OpenHolidays API Nager.Date (CC BY 4.0) (MIT) cantons · Schularten long weekends school + public bridge days
Rationale (verified live on 2026-07-19):
- All ten documented OpenHolidays endpoints answered HTTP 200 with plausible payloads;
/Subdivisions?countryIsoCode=CHreturns exactly 26 cantons, matching the official count. - No public bulk dump could be verified at build time (
openpotato/openholidays.dataraw access returned 404), so Architecture B was not available. - Holiday tables change a handful of times per year, so a 12-hour in-memory TTL removes almost all upstream load without risking staleness.
Consequences:
- Every response carries
provenance(live_api|cached|degraded). - Upstream failure yields a
degradedenvelope with an explanatorynote, never a silent empty list. source_statusalways returns an evaluable health report.
Live-probe findings (2026-07-19)
| Endpoint | HTTP | Status | Records | Note |
|---|---|---|---|---|
/Countries | 200 | ✅ works | 36 | |
/Subdivisions?countryIsoCode=CH | 200 | ✅ works | 26 | matches official canton count |
/Groups?countryIsoCode=CH | 200 | ✅ works | 11 | *Schulart* groups, only 6 cantons |
/PublicHolidays (CH, 2026) | 200 | ✅ works | 39 | cantonal scope included |
/SchoolHolidays (CH, 2026) | 200 | ✅ works | 193 | 183 distinct after school-type split |
/SchoolHolidaysByDate | 200 | ✅ works | – | |
/SchoolHolidays?countryIsoCode=XX | 200 | ⚠️ silently empty | 0 | invalid country ≠ error |
/Subdivisions?languageIsoCode=ZZ | 200 | ⚠️ silent EN fallback | 26 | invalid language ≠ error |
/SchoolHolidays without date range | 400 | ✅ correct error | – | RFC 9110 problem+json |
Nager /PublicHolidays/2026/CH | 200 | ✅ works | 33 | 29 rows carry counties |
Nager /LongWeekend/2026/CH | 200 | ✅ works | 3 | |
Nager /PublicHolidays/2026/XX | 404 | ✅ correct error | – | stricter than OpenHolidays |
Known findings
- Apparent duplicates are school types. Zurich returns *Frühlingsferien 2026* twice: once for
CH-ZH-VS(Volksschulen, taggedRecommended) and once forCH-ZH-BS+CH-ZH-MS(Berufsfach- and Mittelschulen). Use theschool_typeparameter (VS/MS/BS/EO) rather than de-duplicating. - Only six cantons differentiate by school type (AI, AR, BE, GR, SO, ZH). Elsewhere
groupsis absent and one table covers everything. The filter therefore treats an absentgroupsfield as "applies to all". - Subdivision codes mix levels. Records may carry
CH-AI-APorCH-BE-TH-BL. Always match on theCH-XXprefix, never on string equality. - An empty list is not an answer. An unknown country or canton code yields HTTP 200 with
[]. This server sets an explanatorynoteso that "no holidays" and "bad filter" stay distinguishable.
Prerequisites
- Python 3.10 or high