EduPage MCP Server

Project

A Model Context Protocol (MCP) server that exposes the full functionality of the edupage-api Python library to AI agents such as opencode, Claude, Cursor and any other MCP client.

EduPage is a school information system used across Europe. This server lets you query and operate a student / teacher / parent EduPage account directly from your agent: timetables, grades, homework, substitutions, meals (including ordering), messages, rosters, parent child-switching and more — including multiple schools (e.g. two children attending different schools).

⚠️ Unofficial API. Like all EduPage MCP servers, this relies on the community-maintained edupage-api library, which talks to EduPage's undocumented endpoints. Use read-only features freely; use the write features (send_message, meal ordering, child switching) carefully.

---

Table of Contents

• Why another EduPage MCP server?
• What it provides
• Getting started
  • Prerequisites
  • 1. Install
  • 2. Configure credentials
  • 3. Register with your MCP client
• Prompt examples
• Multiple schools (subdomains)
• Tool reference
• Data & safety notes
• Contributing
• Limitations
• Support
• License

---

Why another EduPage MCP server?

Three EduPage MCP servers exist. All three wrap the same community-maintained edupage-api library — none of them reimplements EduPage's undocumented endpoints from scratch. I have no affiliation with the other two; they are listed here because an honest comparison is more useful than a marketing page.

	this project	mrtineu/edupage-mcp	mhlavac/edupage-mcp
Install	uvx edupage-mcp-full, pip, or one-click from the MCP Registry	uvx edupage-mcp (PyPI)	clone + uv sync
Tools	29 (consolidated — see note)	13	26
License	MIT	Apache-2.0	GPL-3.0
Stars	1	2	1
Repo created	2026-09-03	2026-06-05	2026-02-21
Last push	2026-09-28	2026-09-16	2026-09-22
Test suite	✅ (pytest, run in CI)	❌	✅

Two things worth stating plainly before the feature table. This is the newest and least-adopted of the three — as of 2026-09-28 it is 25 days old with a single star, while mhlavac/edupage-mcp predates it by over six months. And tool count is a poor metric: this project deliberately folds families behind a discriminating parameter (get_roster(roster_type=…), get_timeline(category=…)) rather than shipping near-identical tools, so its 29 tools cover ground that takes the others 26 or 13 separate ones. The table below is therefore written by capability, not by tool name.

Capabilities

Capability	mhlavac	mrtineu	this project
Login — credentials	✅	✅	✅
Login — portal auto-detect	✅	❌	✅
Login — 2FA completion	❌	❌	✅
Login — existing PHPSESSID	❌	❌	✅
Multiple schools in one deployment	✅	❌	✅
Timetable — own	✅	✅	✅
Timetable — by student	✅ (by name)	❌	✅ (name or id)
Timetable — by class	✅	❌	✅
Timetable — by teacher	❌	❌	✅
Timetable — by classroom	❌	❌	✅
Timetable — over a date range	❌	❌	✅
Next-week timetable	✅	❌	✅
Grades	✅	✅	✅
Substitutions / timetable changes	✅	✅	✅
Missing teachers	❌	✅ (experimental)	✅
Meals — read menu	✅	✅	✅
Meals — choose / sign off / rate	❌	❌	✅
Send messages	✅ (open bug #5)	❌	✅
Parent — list own children	✅	❌	✅
Parent — switch session into a child	❌	❌	✅
Bell schedule (periods)	✅	❌	✅
Next ringing time (live)	❌	❌	✅
Homework — from notifications	✅	✅	✅
Homework — body text + attachments	❌	✅	❌
Download a homework file to disk	❌	✅	❌
Absences	✅	❌	✅
Upcoming events	✅	❌	✅
School news	✅	❌	✅
Assignments (tests / exams)	✅	❌	✅
Roster — students/teachers/classes/classrooms/subjects	✅	partial	✅
Whole-school roster	✅	❌	✅
"Is the kid at school today?"	✅	❌	❌
Aggregate summary	✅ (last N days)	❌	✅ (one day)
Raw custom HTTP request	❌	❌	✅
Role detection (parent/student/teacher)	❌	❌	✅
Auto re-login on expired session	❌	✅	✅ (several tools)
Automated tests in CI	lint only	❌	✅

Where the other two are genuinely better

The table above is not one-sided, and it would be dishonest to leave it there: