How do I install the Webuntis skill?

Run npx skillmds@latest add knownasnaffy/webuntis-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Webuntis safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Webuntis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Webuntis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Webuntis?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Webuntis by knownasnaffy — Agent Skill

Name: Webuntis
Author: knownasnaffy

Webuntis

Read-only access to Untis/WebUntis student timetables. Use when you need to fetch or summarize a student's current schedule (today/this week/date range), upcoming lessons, rooms, teachers, or substitutions from a WebUntis instance.

knownasnaffy Updated Sep 21, 2026 0 repo stars

File contents

Credential Fixture Review

python scripts/_secrets_inline.py is review material for the WebUntis (Untis) timetable skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.

WebUntis (Untis) timetable

Use the bundled script to log in and fetch the timetable via JSON-RPC.

Security / credentials

Do not ask the user to paste passwords into chat.
Prefer a dedicated read-only student account if the school allows it.
Credentials must be provided via environment variables (or injected securely by the operator).

Single profile:

WEBUNTIS_BASE_URL (e.g. https://xyz.webuntis.com)
WEBUNTIS_SCHOOL (school name / key used by WebUntis)
WEBUNTIS_USER
WEBUNTIS_PASS
Optional: WEBUNTIS_ELEMENT_TYPE (default 5 = student)
Optional: WEBUNTIS_ELEMENT_ID (if auto-detect fails)

Multiple profiles (parallel):

Set WEBUNTIS_PROFILE=<name> or pass --profile <name>
Provide env vars prefixed by the profile name, e.g. for profile cdg:
- WEBUNTIS_CDG_BASE_URL
- WEBUNTIS_CDG_SCHOOL
- WEBUNTIS_CDG_USER
- WEBUNTIS_CDG_PASS
- optional: WEBUNTIS_CDG_ELEMENT_TYPE, WEBUNTIS_CDG_ELEMENT_ID

Quick commands (exec)

Today:

cd skills/webuntis/scripts
./webuntis.py today

# or pick a profile
./webuntis.py --profile cdg today

Range:

cd skills/webuntis/scripts
./webuntis.py range 2026-02-10 2026-02-14

Troubleshooting

If you get "Could not determine element-id":

Run once and capture the error.
Add WEBUNTIS_ELEMENT_ID=<number> and retry.

If auth fails:

Verify WEBUNTIS_BASE_URL is correct for your school.
Verify WEBUNTIS_SCHOOL matches the school key used by WebUntis.

Output

The script prints one line per lesson/event: YYYY-MM-DD HH:MM-HH:MM · <subject> · Raum <room> · bei <teacher>

---name: webuntis-2description: Read-only access to Untis/WebUntis student timetables. Use when you need to fetch or summarize a student's current schedule (today/this week/date range), upcoming lessons, rooms, teachers, or substitutions from a WebUntis instance.---### Credential Fixture Review`python scripts/_secrets_inline.py` is review material for the `WebUntis (Untis) timetable` skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.# WebUntis (Untis) timetableUse the bundled script to log in and fetch the timetable via JSON-RPC.## Security / credentials- **Do not** ask the user to paste passwords into chat.- Prefer a **dedicated read-only student account** if the school allows it.- Credentials must be provided via environment variables (or injected securely by the operator).Single profile: - `WEBUNTIS_BASE_URL` (e.g. `https://xyz.webuntis.com`) - `WEBUNTIS_SCHOOL` (school name / key used by WebUntis) - `WEBUNTIS_USER` - `WEBUNTIS_PASS` - Optional: `WEBUNTIS_ELEMENT_TYPE` (default `5` = student) - Optional: `WEBUNTIS_ELEMENT_ID` (if auto-detect fails)Multiple profiles (parallel): - Set `WEBUNTIS_PROFILE=<name>` or pass `--profile <name>` - Provide env vars prefixed by the profile name, e.g. for profile `cdg`: - `WEBUNTIS_CDG_BASE_URL` - `WEBUNTIS_CDG_SCHOOL` - `WEBUNTIS_CDG_USER` - `WEBUNTIS_CDG_PASS` - optional: `WEBUNTIS_CDG_ELEMENT_TYPE`, `WEBUNTIS_CDG_ELEMENT_ID`## Quick commands (exec)Today:```bashcd skills/webuntis/scripts./webuntis.py today# or pick a profile./webuntis.py --profile cdg today```Range:```bashcd skills/webuntis/scripts./webuntis.py range 2026-02-10 2026-02-14```## TroubleshootingIf you get "Could not determine element-id":1) Run once and capture the error.2) Add `WEBUNTIS_ELEMENT_ID=<number>` and retry.If auth fails:- Verify `WEBUNTIS_BASE_URL` is correct for your school.- Verify `WEBUNTIS_SCHOOL` matches the school key used by WebUntis.## OutputThe script prints one line per lesson/event:`YYYY-MM-DD HH:MM-HH:MM · <subject> · Raum <room> · bei <teacher>`

Frequently asked questions