untis-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
untis-mcp
Read-only MCP server for WebUntis (school timetable system): lets AI agents read the timetable, timetable changes, homework, exams, absences and messages of a student account – with redaction of personal data. Only the last names (and abbreviations) of teachers are shown; the student appears as "Ich"/"Me", everybody else as a pseudonym.
Agent ──MCP──▶ untis-mcp ──JSON-RPC/REST──▶ https://<your-school>.webuntis.com
│
└─ teachers by last name only, pseudonyms for everyone else,
strips e-mail/phone/links/tokens, returns allowlisted results onlyWorks with SSO accounts (e.g. school portal login): login via the Untis Mobile QR code (app secret + TOTP). Native accounts can also use a password.
Bun + TypeScript, stdio or Streamable HTTP, Docker image.
Specification:
docs/mcp-server-spec.md· API findings:docs/untis-api.md· Open items:docs/roadmap.md
⚠️ Disclaimer
Unofficial. This project is not affiliated with, endorsed by or supported by Untis GmbH. "WebUntis" and "Untis" are trademarks of their owner.
It uses undocumented APIs of the WebUntis web app and the Untis Mobile app. They can change or break at any time without notice.
It is read-only: it cannot send messages, excuses or read confirmations, or change anything else.
You are responsible for complying with the terms of use of your school and of WebUntis, and with data-protection law (e.g. the GDPR) – especially because the data concerns minors and third parties (classmates, teachers) and absence reasons can be health data. Only use it with an account you are entitled to use.
Pseudonymisation is not anonymisation. Redaction considerably reduces what reaches an AI model, but it cannot catch everything (see Privacy). File and image contents are not redacted – only extracted text is.
Provided "as is", without warranty (see LICENSE).
Related MCP server: Schulmanager Online MCP Server
Tools
Tool | Content |
| today + next school day: lessons, changes, homework due, exams, unread messages, messages of the day |
| timetable for a range (default: current week), double lessons merged, changes with original/new teacher and room |
| only cancellations, substitutions, room changes, additional/moved lessons |
| lesson topic, notes, homework and files of one lesson |
| homework with due date, subject, teacher, attachments |
| exams (no participant lists, no grades) |
| own absences with excuse status and totals |
| message centre ("Mitteilungen") |
| school-wide messages of the day |
| subjects, teachers, rooms, classes, time grid, holidays, school years |
| attachments; PDF/DOCX/text as redacted text |
All tools are read-only. The server never sends read confirmations, replies or excuses.
Privacy
Every tool returns its own slim DTO (allowlist) – raw API responses never reach the agent.
Teachers: last name + abbreviation (
KEEP_TEACHER_ABBREVIATIONS), never first names; optional salutation viaDATA_DIR/teachers.json;REDACT_TEACHERS=truepseudonymises them too.The student →
Ich; classmates →Schüler:in-7F3A; parents →Elternteil-…; others →Person-…(stable HMAC pseudonyms).Free text (lesson texts, homework, messages, file text) goes through a name dictionary built from all students and teachers of the school (kept in memory only), plus filters for e-mail addresses, phone numbers, WebUntis/storage links and tokens.
Never in the output: person ids, gender, exam participant lists, disadvantage-compensation flags, grades, staff notes.
Limits: names of people outside WebUntis (e.g. parents who never wrote a message) are not detected in free text; images and file blobs are not redacted; absence reasons can be health data (
ABSENCE_TEXTS=dropremoves them). Pseudonymisation is not anonymisation.
Setup
1. Get the app secret (QR code)
In WebUntis (browser, logged in as the student): profile → "Freigaben" (sharing) → Untis Mobile → show. The QR code contains a link like
untis://setschool?url=yourschool.webuntis.com&school=yourschool&user=USERNAME&key=SECRETRead it with a QR reader app (no online service – the key works like a password) or copy server, school, user and key from the text shown next to the code. Creating a new QR code invalidates the old key.
2a. Docker (HTTP)
cp -r secrets.example secrets # PowerShell: Copy-Item -Recurse secrets.example secrets
# fill secrets/untis_qr_url and secrets/mcp_api_key (see secrets.example/README.txt)
docker compose pull && docker compose up -d # prebuilt image ghcr.io/ludoo0/untis-mcp (linux/amd64, linux/arm64)
# or build locally: docker compose up -d --buildPin a version with UNTIS_MCP_VERSION=0.1.0 (default: latest), change the host port with UNTIS_MCP_PORT (default 3000) – both can go into a .env file next to compose.yaml.
The server listens on http://127.0.0.1:3000/mcp (bearer API key), health check at /healthz. Connect e.g. Claude Code:
claude mcp add --transport http untis http://127.0.0.1:3000/mcp --header "Authorization: Bearer <MCP_API_KEY>"2b. Local (stdio)
bun install
cp .env.example .env # set UNTIS_QR_URL (or the single values)
claude mcp add untis -- bun run /path/to/untis-mcp/src/server.tsConfiguration
See .env.example and spec section 3. Most important:
Variable | Default | |
| – | QR code link (sets server, school, user, secret) |
| – | alternative to the QR link |
|
|
|
| – | required for |
|
|
|
|
| pseudonymise teachers too |
|
|
|
|
| school time zone |
|
| pseudonym secret, |
Development
bun install
bun run lint && bun run typecheck && bun test # tests use fictional data only, no network
bun run call [tool] [key=value…] # call a tool against the real account (.env)
bun run smoke [--details] # leak check against the real account – output is masked and shareable
bun run probe # structure-only API probe (docs/untis-api.md)License
MIT – not affiliated with Untis GmbH.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Read-only MCP server for RZ AI Labs — query its services, workshops, and contact info.
Read-only WhatsApp MCP for your AI agent: it reads the chats you choose. Try the public demo.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for accessing Dutch school schedules from Magister. Enables Claude and other MCP-compatible AI assistants to query school schedules, drop-off times, and pick-up times.48 npm7MIT
- AlicenseNot gradedqualityDmaintenanceA local MCP server that enables LLMs like Claude to access Schulmanager Online data including schedules, homework, exams, grades, and parental letters.1-
- AlicenseAqualityDmaintenanceEnables AI clients to read DTU Learn classes, assignments, deadlines, exams, and recent calendar changes through a local MCP server, using a cached SQLite store for fast and resilient queries.6MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to access and query WebUntis school data, including timetables, homework, exams, absences, and more via MCP tools.-