Skip to main content
Glama

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

portal_dashboard

Main dashboard — student name, pinned items, week's attendance, timetable highlights

portal_inbox

List inbox items; filter: all / unread / messages / events

portal_evaluations

Grades by subject, by date, or trends

portal_assignments

Homework — upcoming, today, recent, archive

portal_exams

Written tests and oral exams — upcoming or archive

portal_materials

Teaching/learning materials; optional course filter

portal_lesson_plans

Lesson plan / curriculum content per week

portal_timetable

Student timetable — current week, static, upcoming events, archive. Use offset (multiples of 7) to navigate weeks: 7 = next week, -7 = last week, 14 = two weeks ahead, etc. Use term to select a school year (e.g. 2026/27).

portal_terms

List available school terms/years

portal_attendance

Attendance records and stats (retroactive excuse, forward report, stats, overview)

portal_excuse_absence

Submit a retroactive absence excuse for specific dates

portal_report_absence

Report a future absence by day or by lesson

portal_messages

List inbox / sent / archive messages

portal_get_message

Full content of a single message by ID

portal_send_message

Compose and send a new message

portal_payments

Payment history and outstanding balances

portal_discussions

Parent-teacher discussion slots — upcoming or archive

portal_courses

Enrolled courses, class groups, course enrolments

portal_portfolios

Student portfolio work items

portal_library

Borrowed and available library books

portal_consents

Consent forms and their status

portal_search

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.js

3. Environment variables

Variable

Required

Description

EDOOKIT_SCHOOL

yes

Subdomain — if your portal is https://zs-example.edookit.net, use zs-example

EDOOKIT_USERNAME

no

Plus4U login (email). If omitted, a visible browser window opens for interactive login.

EDOOKIT_PASSWORD

no

Plus4U password. Required together with EDOOKIT_USERNAME for headless mode.

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, and portal_send_message submit 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_search depends on whether the school has search enabled in their Edookit instance.

  • portal_timetable with offset fires 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 tools
portal_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_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

    B3.4/5.0

    Scored across 21 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      C
      quality
      C
      maintenance
      Enables interaction with the Edookit school management system API, exposing attendance, lessons, people, grades, payments, courses, timetable, and individual goals as MCP tools.
      46
      -
    • F
      license
      A
      quality
      D
      maintenance
      Provides 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.
      11
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      31
      131 PyPI
      4
      MIT