ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

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.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/finnbusse/webuntis
Or

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

  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.

Output

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

Read Full Documentation on GitHub

Metadata

Author@finnbusse
Stars2387
Views0
Updated2026-03-09
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-finnbusse-webuntis": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

iserv

HTTP client for IServ school platforms. Log in to an IServ instance (e.g. https://grabbe-dt.de) and fetch common student data like unread mail counts, calendar events, files/folders, tasks/exercises, announcements/news, and other IServ modules via HTTP endpoints. Includes best-effort file ops + exercise submission.

finnbusse 2387