edookit-portal
This server is an MCP tool that scrapes the Edookit parent/student portal to let you read and manage student data via a set of tools.
View dashboard: student name, pinned items, weekly attendance, timetable highlights
Check inbox: filter by unread/messages/events
Get grades by subject, date, or trends
View homework assignments: upcoming, today, recent, archive
View upcoming or past exams
Browse teaching materials and lesson plans
Get student timetable by week, with offsets for future/past weeks
List available school terms/years
Access attendance records and stats
Submit actions: excuse past absences, report future absences, send messages
Manage messages: list inbox/sent/archive, read full messages, compose/send
View payment history and outstanding balances
See parent-teacher discussion slots
View enrolled courses, class groups, enrollments
Browse student portfolio items
Check borrowed/available library books
Review consent forms and their status
Perform full-text portal search if enabled
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@edookit-portal Show my upcoming homework assignments"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
edookit-legacy-mcp
MCP server for the Edookit parent/student portal (*.edookit.net). Scrapes the portal web UI because the Edookit REST API is only available when separately enabled by the school.
21 tools
Tool | Description |
| Main dashboard — student name, pinned items, week's attendance, timetable highlights |
| List inbox items; filter: all / unread / messages / events |
| Grades by subject, by date, or trends |
| Homework — upcoming, today, recent, archive |
| Written tests and oral exams — upcoming or archive |
| Teaching/learning materials; optional course filter |
| Lesson plan / curriculum content per week |
| Student timetable — current week, static, upcoming events, archive. Use |
| List available school terms/years |
| Attendance records and stats (retroactive excuse, forward report, stats, overview) |
| Submit a retroactive absence excuse for specific dates |
| Report a future absence by day or by lesson |
| List inbox / sent / archive messages |
| Full content of a single message by ID |
| Compose and send a new message |
| Payment history and outstanding balances |
| Parent-teacher discussion slots — upcoming or archive |
| Enrolled courses, class groups, course enrolments |
| Student portfolio work items |
| Borrowed and available library books |
| Consent forms and their status |
| Full-text search across the portal |
Related MCP server: edookit-mcp
Setup
1. Install via npx (no build needed)
{
"mcpServers": {
"edookit-portal": {
"command": "npx",
"args": ["github:thewulf7/edookit-legacy-mcp"],
"env": {
"EDOOKIT_SCHOOL": "your-school",
"EDOOKIT_USERNAME": "your@email.com",
"EDOOKIT_PASSWORD": "yourpassword"
}
}
}
}2. Build from source (optional)
git clone https://github.com/thewulf7/edookit-legacy-mcp
cd edookit-legacy-mcp
npm install
npx playwright install chromium
npm run build
node dist/index.js3. Environment variables
Variable | Required | Description |
| yes | Subdomain — if your portal is |
| no | Plus4U login (email). If omitted, a visible browser window opens for interactive login. |
| no | Plus4U password. Required together with |
4. Authentication
Headless (recommended): provide EDOOKIT_USERNAME + EDOOKIT_PASSWORD. The server logs in via Playwright, saves the Plus4U OIDC session to ~/.cache/edookit-legacy-mcp/profile-<school>/session-storage.json, and uses a fast silent re-auth on subsequent starts — no browser window, no manual steps.
Interactive: omit credentials. On the first tool call a visible Chrome window opens at the portal login page. Complete the Plus4U / Google login manually. Once authenticated the window closes and the session is cached. This only works on a machine with a display.
To force a full re-login, delete ~/.cache/edookit-legacy-mcp/profile-<school>/.
Notes
Read-only by default — only
portal_excuse_absence,portal_report_absence, andportal_send_messagesubmit data.All text is in Czech (the portal language); field values are returned as-is.
Pages with no data return empty arrays — this is normal for accounts with no activity yet.
portal_searchdepends on whether the school has search enabled in their Edookit instance.portal_timetablewithoffsetfires a server-side session filter via AJAX before fetching the page, so the offset persists for the duration of the MCP process session.
Available Tools
21 toolsportal_assignmentsC
Get homework assignments (upcoming, today, recent, or archive).
Inputs: view.
portal_attendanceB
Get attendance records and statistics. Views: excuse (retroactive), report (forward by day), report-lesson (forward by lesson), excused, stats, overview.
Inputs: view.
portal_consentsA
Get consent forms (agreements) and their status.
Inputs: no named parameters.
portal_coursesA
Get enrolled courses, class groups, or available course enrolments.
Inputs: view.
portal_dashboardA
Get the main dashboard — student name, pinned items, this week's attendance, and timetable highlights.
Inputs: no named parameters.
portal_discussionsA
Get upcoming or archived discussions (parent-teacher talks).
Inputs: view.
portal_evaluationsB
Get grades and evaluations grouped by subject.
Inputs: view.
portal_examsA
Get upcoming or past exams and written tests.
Inputs: view.
portal_excuse_absenceB
Submit a retroactive excuse for absences on specific dates.
Inputs: dates (required), reason (required).
portal_get_messageA
Get the full content of a single message by its ID.
Inputs: id (required).
portal_inboxB
List inbox items (messages, events, assignments, etc.). Optionally filter by type.
Inputs: filter.
portal_lesson_plansB
Get lesson plans / curriculum content for the student.
Inputs: week.
portal_libraryB
Get borrowed and available library books.
Inputs: no named parameters.
portal_materialsC
Get teaching/learning materials. Optionally filter by course ID.
Inputs: courseId.
portal_messagesA
List inbox, sent, or archived messages.
Inputs: page, view.
portal_paymentsA
Get payment history and outstanding balances.
Inputs: personId.
portal_portfoliosB
Get student portfolio work items.
Inputs: studentId.
portal_report_absenceB
Report a future (upcoming) absence by day or by lesson.
Inputs: mode (required), reason (required), dateFrom (required), dateTo.
portal_searchB
Search the portal for any content by keyword.
Inputs: query (required).
portal_send_messageB
Compose and send a new message to a recipient.
Inputs: to (required), body (required), subject (required).
portal_timetableA
Get the student timetable. Views: current week, static (permanent), upcoming events, archive.
Inputs: view, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Most tools map cleanly to distinct portal sections, but portal_inbox and portal_messages both expose message-like items and could cause selection confusion. The attendance views also overlap conceptually with the separate absence reporting/excuse tools, though descriptions make the read vs. submit distinction clear.
Tool names consistently use a portal_ prefix and snake_case, and most retrieval tools follow a portal_<resource> pattern. Minor deviations such as portal_get_message, portal_send_message, and portal_report_absence break the otherwise uniform noun pattern.
21 tools is on the heavy side, though each maps to a real feature area of a student portal. Some redundancy between inbox/messages and attendance/absence tools means the set could likely be consolidated without losing capability.
The toolkit covers the main read surfaces of a school portal: assignments, exams, timetable, attendance, payments, library, consents, and more. Missing write actions such as submitting consents or booking discussions are minor gap relative to the portal's apparent read-heavy purpose.
Maintenance
Related MCP Connectors
Secure remote MCP for supported accounting workflows in authorized Money S3 companies.
Remote MCP for TehProf Booking: browse resources & availability, create & cancel reservations.
Secure remote MCP for supported accounting workflows in authorized STORMWARE POHODA companies.
MCP adapter for the Paxaver school community platform. Streamable HTTP, OAuth 2.1, capability auth.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server that connects Claude to Edupage, a school information system used across Europe. Provides access to timetables, grades, homework, messages, students, teachers, and more.251GPL 3.0
- FlicenseCqualityCmaintenanceEnables interaction with the Edookit school management system API, exposing attendance, lessons, people, grades, payments, courses, timetable, and individual goals as MCP tools.46-
- FlicenseAqualityDmaintenanceProvides read-only access to Librus parent account data for multiple children, enabling retrieval of grades, attendance, timetable, calendar, homework, announcements, messages, and attachments via MCP.111-
- AlicenseAqualityBmaintenanceEnables AI agents to query and manage EduPage school accounts, including timetables, grades, homework, meals, messages, multi-school discovery, role-aware student switching, and 2FA login.31131 PyPI4MIT