Ferien — German school holidays by year & federal state

● Active

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

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

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "ferien-mcp": {
      "command": "uvx",
      "args": [
        "ferien-mcp"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add ferien-mcp -- uvx ferien-mcp
OpenAI Codex CLI
codex mcp add ferien-mcp -- uvx ferien-mcp
VS Code
code --add-mcp '{"name":"ferien-mcp","type":"stdio","command":"uvx","args":["ferien-mcp"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Education & Reference
Version
0.1.0
Registry
active
Published
11/15/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 18, 2026

Looks healthy: Ferien — German school holidays by year & federal state is maintained, open source.

Maintained
Active
Last commit 7 days ago (Nov 15, 2026), 0 open issues.
Official registry
Active
Published as io.github.mohammad-abbasi-sh/ferien-mcp in the official MCP registry, version 0.1.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
On your machine
A local PyPI package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 15, 2026
License
MIT

Pythonfastmcpferiengermanymcpmodel-context-protocolpythonschool-holidays

From the README

ferien-mcp 🏖️ mcp-name: io.github.mohammad-abbasi-sh/ferien-mcp Unofficial read-only MCP server for German school holidays (Schulferien) via the ferien-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 ferien-api.de / the bundesAPI project. For AI agents Add to your MCP client config (stdio): Or run locally: python -m ferien_mcp.server (needs mcp<2, httpx). Tools Example output (ferienisholiday / 2026-08-10, BY): Notes: • State codes are the 2-letter codes: BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH. There is no nationwide list — school holidays are per-state, so every query needs one state. Use ferienliststates for the full list. • Holiday names are German ("sommerferien bayern 2026"); each row also carries a kind (winterferien, frühjahrsferien, osterferien, pfingstferien, sommerferien, herbstferien, weihnachtsferien, beweglicher ferientag) and the duration in days. • Coverage varies by state and year: the API returns an empty list for a state/year it has no data for — e.g. Berlin 2026 was empty on 2026-11-14 while Berlin 2025 has 7 entries. Verify important dates against the official source. • Cross-year holidays (e.g.…

Read the full README on GitHub →

The most-starred Education & Reference servers in the index, with their live-check result.

ServerStarsLast pushLive check
Honcho8,178Nov 2026Needs sign-in
Zotero MCP6,020Nov 2026Local / not checked
Tolgee4,162Nov 2026Working
LearnHouse2,485Nov 2026Needs sign-in
obsei1,454Nov 2026Local / not checked

Ferien — German school holidays by year & federal state: questions people ask

Is Ferien — German school holidays by year & federal state a remote or a local MCP server?
According to its entry in the official MCP registry, Ferien — German school holidays by year & federal state ships as a local package (PyPI) that your client starts on your machine.
Is Ferien — German school holidays by year & federal state safe to use?
Looks healthy: Ferien — German school holidays by year & federal state is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: None declared. Serverdex check of Nov 18, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Ferien — German school holidays by year & federal state still maintained?
Active: the repository's last commit 7 days ago. Last push Nov 15, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add Ferien — German school holidays by year & federal state to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.

More from mohammad-abbasi-sh

All 52 servers by mohammad-abbasi-sh →
  1. Bonbama DiscountsUnofficial read-only MCP server for bonbama.ir — Gorgan discounts, businesses and codes.
  2. Migros Sanal MarketUnofficial MCP server for Migros Sanal Market — search, prices, promos, categories, cart.
  3. hepsiburada.com ShoppingUnofficial MCP server for hepsiburada.com: search, prices, reviews; local-session cart + favorites.
  4. İŞKUR JobsUnofficial read-only MCP server for İŞKUR — open job listings, details, provinces, announcements.
Browse all Education & Reference →

Add the badge to your site

Show visitors that Ferien — German school holidays by year & federal state is listed here — it’s also the link we check for a free listing.

Ferien — German school holidays by year & federal state — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mohammad-abbasi-sh-ferien-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Ferien — German school holidays by year & federal state — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Ferien — German school holidays by year & federal state — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mohammad-abbasi-sh-ferien-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-mohammad-abbasi-sh-ferien-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-mohammad-abbasi-sh-ferien-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-mohammad-abbasi-sh-ferien-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-mohammad-abbasi-sh-ferien-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-mohammad-abbasi-sh-ferien-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-mohammad-abbasi-sh-ferien-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).