Log in to Edupage for a subdomain. If username/password/subdomain are omitted, env vars EDUPAGE_USERNAME, EDUPAGE_PASSWORD, EDUPAGE_SUBDOMAINS are used. Multiple schools are supported: each login call adds/replaces that subdomain's session (see login_all). If 2FA is enabled, returns instructions to call two_factor_check_confirmed / two_factor_finish.

Log in to one or more schools using multiple subdomains in a single call. Pass comma-separated values: subdomains="school1,school2", usernames="u1,u2", passwords="p1,p2" (or pairs with one shared username/ password). Uses env vars for anything not provided.

Log in to Edupage via the portal (auto-detect school). Optionally tag the resulting session with subdomain so multi-school tools can reference it.

Create a logged-in Edupage instance from an existing PHPSESSID cookie.

After a login that required 2FA, check whether the confirmation has been approved on a device. Returns True when safe to call two_factor_finish.

Finish 2FA authentication. If code is provided it is used as an email/app code; otherwise the device-confirmation flow is used (call two_factor_check_confirmed first).

Show login status for all configured subdomains and the active one.

Return the logged-in user's Edupage user id.

Return the current school year (starting year).

Get the timetable for the logged-in user for a date (YYYY-MM-DD, default today).

Get a student's timetable by first/last name OR person_id. Without a subdomain, searches every school in the discovery scope (the configured EDUPAGE_SUBDOMAINS, or all logged-in schools when unset) and returns one result per school where the student is found — so a student attending multiple schools yields separate per-school timetables. If logged in as a parent, this switches to (and back from) the student account for the lookup. Returns the student's lessons plus which student/account/school was used.

Get the timetable for a teacher, student, class or classroom on a date. target_type: 'teacher' | 'student' | 'class' | 'classroom'.

Get the type (break/lesson) and time of the next ringing for a given datetime (ISO, default now).

Get the Mon-Fri timetable for next week for the logged-in user, grouped by weekday.

Get timetable for a target (class, student, teacher, classroom) for every day between start_date and end_date (inclusive). Returns a dict keyed by date (YYYY‑MM‑DD) with each value being the result of get_timetable for that day. Days with no published data get an empty lessons list.

Get the bell schedule (periods with start/end times) from the logged-in data.

Get grades. Optionally filter by year (school year start) and term ('FIRST' or 'SECOND'). Returns list of grades (subject, teacher, percent, etc.).

Get the list of available timeline notifications (homework, tests, messages, grades, events...).

Get timeline notifications since a date (YYYY-MM-DD), including older ones.

Get homework assignments from the recent timeline notifications.

Get all assignments (homework, tests, exams, projects) from the timeline.

Get the student's absence records from the timeline notifications.

Get upcoming school events (trips, excursions, meetings, holidays...).

Get school news from the timeline notifications.

Get substitution/timetable changes for a date (default today).

Get teachers missing on a date (default today).

Get the meal menu (snack/lunch/afternoon snack) for a date (default today).

Tries the personal meal-ordering endpoint first; when the school hasn't enabled it, falls back to the school's public canteen menu widget. By default only snack/lunch/afternoon_snack are returned; set include_breakfast / include_dinner to also include those extra meals (only available via the public widget).

Order/choose a meal for a date. meal_type: 'snack'|'lunch'|'afternoon_snack'. number: 1-based menu choice among the chooseable menus.

Cancel an ordered meal for a date. meal_type: 'snack'|'lunch'|'afternoon_snack'.

Rate a meal (1-5 quality and quantity) for a date and meal type.

One-call daily school report for a date (default today): timetable, substitutions, missing teachers, grades received that day, meals, homework, assignments, absences, news, events, and timeline notifications.

Composes the individual section tools so you don't need to fire 8-10 calls to answer "what happened yesterday at school" or "what's coming tomorrow".

• If name/student_id is provided: report for that specific student (found across all schools unless subdomain scopes it).

• If omitted: discovery-first — for a parent this returns a lightweight per-school index of the account's children (no per-child section fetching), so you can then call per child with name/student_id. Set full=True to instead build the full report for every child.

• If omitted and logged in as student/teacher: report on the logged-in account. Every section is isolated — a failure in one section yields {"ok": false, "error": ...} without failing the report.

Get all students in the logged-in user's class.

Get a short list of all students in the school.

Get all teachers in the school.

Get all classes in the school.

Get all classrooms in the school.

Get all subjects in the school.

Send a message to a recipient. recipient_id is an edupage id like 'Student123' or 'Teacher456' (see get_students/get_teachers).

Get students visible to the logged-in account: parent accounts see their linked children (parsed from the school homepage); student accounts see classmates. Uses cached data. Returns person_id, name, class_id — usable with switch_to_student and get_student_timetable.

Switch to a student account (parent accounts only). Provide student_id (person_id) or name (first/last/full name).

Look up a student by first/last/full name using tiered matching. Without a subdomain, searches ALL logged-in schools and returns one result per school where the student is found. Returns student info with match confidence tiers (1=exact, 2=first name, 3=last name, 4=substring). Use student_id from results with get_student_timetable for unambiguous lookups.

List all schools the server is logged into (from auto-discovery or login_all). Returns each subdomain with its login state, role (student/parent/teacher), 2FA pending status, and user id.

Force refresh of cached student data. Call this after students are added/removed from a school, or if scan_students/find_student returns stale results. Without a subdomain, clears the cache for ALL schools.

Discover all students visible to the logged-in account across the discovery scope (the configured EDUPAGE_SUBDOMAINS, or every school when unset). For a parent account: their linked children in each school. For a student account: classmates in each school. Returns one entry per student per school, so a multi-school student appears with separate per-school records. Uses cached data to avoid redundant API calls.

Switch back to the parent account (parent accounts only).

Send a raw request to the Edupage server using the active session. method: 'GET'|'POST'. Returns status code and body text.