untis-mcp

What it does

untis-mcp is an HTTP MCP server that connects AI assistants to WebUntis school scheduling data. It allows the AI to retrieve detailed timetables for classes, teachers, and rooms, find available substitutes, and check for room availability, all using a shared service account via a secret-gated endpoint.

Tools

• getTimetable: Retrieve timetables for a class, teacher, or room over a date range.
• getWeekOverview: Get a full weekly view of schedules grouped by day.
• findSubstituteTeachers: Identify qualified teachers who are free during a specific time slot.
• findAvailableRooms: List all rooms free at a given date and time.
• getTeacherWorkload: Calculate lesson count and subject distribution for teachers.

Installation

Deploy as a Docker container and add the connector URL to your MCP client:

{
  "mcpServers": {
    "untis": {
      "url": "https://<your-host>/untis/<MCP_SECRET>"
    }
  }
}

Supported hosts

• Claude.ai: Confirmed via Streamable HTTP connector.