Mensa-Today

Returns the daily menu of a German university canteen, sourced from the public OpenMensa API (https://openmensa.org). No API key needed.

When to use

Trigger this skill when the user asks for today's (or another day's) canteen / "Mensa" menu, e.g. "What's for lunch at the Mensa today?" or "Mensaplan heute".

Agent flow

1. No config yet? Ask the user for a city. Optionally ask if they have a favourite canteen in that city — used as the default for queries without a specific canteen.
2. Run setup (non-interactive):

   python3 {baseDir}/mensa_today.py --setup "\x3Ccity>"
   # or, with a preferred default:
   python3 {baseDir}/mensa_today.py --setup "\x3Ccity>" --default "\x3Cfavourite canteen substring>"
   

   All canteens in that city are saved as aliases; one of them is marked as default.
3. Menu queries:

   python3 {baseDir}/mensa_today.py                       # default canteen, today
   python3 {baseDir}/mensa_today.py "UniCampus"           # any canteen in the city, by name substring
   python3 {baseDir}/mensa_today.py "Otto Hahn" --date 2026-06-02
   

   Substring matching is normalised — special characters (-, ,, .) are ignored, so a query like "Otto Hahn" matches a canteen named "Mensa Otto-Hahn-Straße".
4. "No canteen matched"? The query did not resolve to any saved alias. Show the user the available aliases (the script prints them) and offer to re-run --setup for a different city.

Example output

2026-05-26 - Menu (student price)
- Spaghetti Bolognese - 2.80 EUR
- Couscous - 2.60 EUR (vegetarian)
- Soup - 1.80 EUR (vegan)

Network egress

Outbound HTTPS to openmensa.org only. No credentials, no telemetry, no user data sent. The user's city and canteen choice stay in a local config.json next to the script.

Files

• mensa_today.py — entry point (no third-party deps, stdlib only)
• config.json — created on first --setup, holds chosen canteen ids (gitignored, never uploaded)
• README.md, LICENSE.md