Skip to main content
Glama

edookit-mcp

MCP server for the Edookit school management system API. Exposes all 13 Edookit API modules as 49 MCP tools.

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "edookit": {
      "command": "npx",
      "args": ["github:thewulf7/edookit-mcp"],
      "env": {
        "EDOOKIT_SCHOOL": "your-school-subdomain",
        "EDOOKIT_USERNAME": "api-username",
        "EDOOKIT_PASSWORD": "api-password"
      }
    }
  }
}

EDOOKIT_SCHOOL is the subdomain of your school's Edookit portal — if the portal is at https://zs-example.edookit.net, the subdomain is zs-example.

Docházka (RFID Attendance) module

The attendance module uses HMAC authentication and requires prior vendor registration with Edookit (email support@edookit.com). Once registered, add three extra env vars:

"EDOOKIT_HMAC_CLIENT_ID": "your-client-id",
"EDOOKIT_HMAC_CLIENT_KEY": "your-client-key",
"EDOOKIT_HMAC_MARK": "your-mark"

Related MCP server: edookit-portal

Tools

Attendance / Docházka (HMAC auth)

Tool

Description

attendance_version

Service version (public, no auth)

attendance_settings

Current school year and semester

attendance_classes

List classes; optional pk to get one

attendance_schedule_groups

Schedule groups and courses

attendance_job_classifications

Staff job classification codebook

attendance_bell_schedule

Teaching period time ranges

attendance_staff

All staff including RFID card numbers

attendance_students

All students including guardian contacts and RFID cards

attendance_daily_schedule

Daily schedule for a person on a date

attendance_passages_by_date

All RFID passages on a date

attendance_passage_by_id

Single passage by ID

attendance_insert_passage

Record a new RFID entry/exit event

Lessons / Hodiny

Tool

Description

lessons_version

API version

lessons_list

Timetable for a day; filters by course, room, teacher, student, class

lessons_rooms

All rooms

lessons_course_types

All course types

lessons_work_types

All work/activity types

People

Tool

Description

person_search

Search by Edookit ID or Plus4U ID; returns roles, children, representatives

student_personal_data

Student personal data as of a reference date

employee_personal_data

Employee personal data as of a reference date

student_statistics

Pseudonymized student statistics (no names, anonymous UUID)

Grades / Hodnocení

Tool

Description

evaluations_list

List evaluations filtered by student, course, or evaluation term

Payments / Platby

Tool

Description

payments_version

API version

payments_categories

Payment categories

payments_currencies

Available currencies

payments_bank_accounts

Configured bank accounts

payments_types

Payment types

payments_organizations

Organizations

payments_list_prescriptions

List prescriptions with filters

payments_create_prescription

Create a prescription with optional per-person overrides

payments_create_payment

Record a payment transaction

payments_update_prescription

Update a prescription

payments_delete_prescription

Delete a prescription or remove persons from it

payments_update_payment

Update a payment record

payments_delete_payment

Delete a payment record

Courses / Kurzy

Tool

Description

courses_version

API version

courses_student_courses

Students with courses, lessons, final evaluations, and attendance %

Timetable

Tool

Description

public_events

Public school events in a date range (no auth required)

changed_timetable

Substitution schedule — only lessons that changed vs original

Direct Attendance / Přímý zápis docházky

Tool

Description

direct_attendance_lessons

Lesson overview for a student on a day

direct_attendance_future_excuse

Submit a future absence notice (avízo)

direct_attendance_current_excuse

Submit a current excuse (omluvenka)

direct_attendance_record

Insert an attendance record with optional status/minutes

direct_attendance_student_overview

Full attendance history for a student

Individual Goals / Individuální cíle

Tool

Description

individual_goals_lesson_content

Individual lesson content per student

individual_goals_learning_agreements

Learning agreements with coach feedback and subcompetences

Notes

  • All dates use YYYY-MM-DD format unless noted otherwise.

  • Person IDs are unique within one Edookit instance but not across different schools.

  • public_events and changed_timetable use the legacy -login.edookit.net base URL automatically.

  • The Timetable creation module (Tvorba rozvrhů) is not yet publicly available in the Edookit API.

Development

git clone https://github.com/thewulf7/edookit-mcp
cd edookit-mcp
npm install
npm run build

Available Tools

46 tools
attendance_bell_scheduleB

Get teaching period time ranges (bell schedule).

Inputs: pk.

attendance_classesA

List classes for the current school year. Optionally filter by class ID.

Inputs: pk.

attendance_daily_scheduleA

Get daily schedule for a person (staff or student) for a specific date, reflecting current timetable changes.

Inputs: pk (required), date (required).

attendance_insert_passageA

Record a new access passage event (RFID entry/exit). Returns HTTP 201 on success.

Inputs: Cas (required), Smer (required), Datum (required), Hlavni (required), +4 more.

attendance_job_classificationsB

List job classifications (work categories) for staff.

Inputs: pk.

attendance_passage_by_idA

Get a single passage record by its ID.

Inputs: pk (required).

attendance_passages_by_dateA

Get all RFID/physical access passages recorded on a given date.

Inputs: date (required).

attendance_schedule_groupsB

List schedule groups and courses. Positive ID = schedule group, negative = course.

Inputs: pk.

attendance_settingsB

Get attendance service settings including current school year and semester.

Inputs: no named parameters.

attendance_staffA

List all school staff (including inactive), optionally filtered by staff ID.

Inputs: pk.

attendance_studentsB

List all students including legal guardian data, optionally filtered by student ID.

Inputs: pk.

attendance_versionA

Get the Edookit Attendance (Docházka) service version. No auth required.

Inputs: no named parameters.

changed_timetableA

Get substitution/changed timetable for a date range. Returns only lessons that changed vs original schedule. Uses legacy -login.edookit.net URL.

Inputs: to, from, teacherNameFormat.

courses_student_coursesA

List students with their courses, lessons, final evaluations, and attendance percentages for an evaluation term.

Inputs: person_id, evalterm_id.

courses_versionA

Get Courses (Kurzy) module API version.

Inputs: no named parameters.

direct_attendance_current_excuseB

Submit a current excuse (omluvenka) for a student's lesson absence.

Inputs: excuse (required), lesson_id (required), student_id (required).

direct_attendance_future_excuseC

Submit a future absence notice (avízo) for a student for a specific lesson.

Inputs: excuse (required), lesson_id (required), student_id (required).

direct_attendance_lessonsB

Get lesson overview for a student on a given day.

Inputs: student_id (required), date.

direct_attendance_recordC

Insert an attendance record for a student in a lesson.

Inputs: lesson_id (required), student_id (required), status, minutes_late, +1 more.

direct_attendance_student_overviewA

Get a student's full attendance history with statuses, notes, excuses, and absence advices.

Inputs: student_id (required), date_to, date_from.

employee_personal_dataA

Get personal data of employees as of a reference date.

Inputs: date, include_inactive_since.

evaluations_listA

List evaluations (grades). At least one of student_id, course_id, or evalterm_id is required.

Inputs: date_to, course_id, date_from, student_id, +1 more.

individual_goals_learning_agreementsB

Get student learning agreements with coach feedback, subcompetences, and validity ranges.

Inputs: date_to, date_from, student_id.

individual_goals_lesson_contentB

Get individual lesson content for students. At least one of student_id, lesson_id, or date_from is required.

Inputs: date_to, date_from, lesson_id, student_id.

lessons_course_typesA

List all course types.

Inputs: no named parameters.

lessons_listA

Get lessons (timetable) for a given day with optional filters. Returns actual (with substitutions) and scheduled state per lesson.

Inputs: date, room_id, class_id, course_id, +4 more.

lessons_roomsA

List all rooms available in this Edookit instance.

Inputs: no named parameters.

lessons_versionB

Get Lessons (Hodiny) module API version.

Inputs: no named parameters.

lessons_work_typesA

List all work/activity types.

Inputs: no named parameters.

payments_bank_accountsA

List bank accounts configured in Edookit.

Inputs: no named parameters.

payments_categoriesB

List payment categories.

Inputs: no named parameters.

payments_create_paymentC

Record a payment transaction.

Inputs: type (required), amount (required), currency_id (required), organization_id (required), +10 more.

payments_create_prescriptionB

Create a new payment prescription, optionally with per-person amount overrides.

Inputs: name (required), due_date (required), state, amount, +8 more.

payments_currenciesA

List currencies available in Edookit.

Inputs: no named parameters.

payments_delete_paymentB

Delete a payment record.

Inputs: id (required).

payments_delete_prescriptionC

Delete a payment prescription or remove persons from it.

Inputs: id (required), person_list, delete_prescription.

payments_list_prescriptionsA

List payment prescriptions with optional filters.

Inputs: date_to, date_from, person_id, payment_id, +4 more.

payments_organizationsA

List organizations in Edookit.

Inputs: no named parameters.

payments_typesB

List payment types.

Inputs: no named parameters.

payments_update_paymentC

Update an existing payment record.

Inputs: id (required), date, type, amount, +9 more.

payments_update_prescriptionC

Update an existing payment prescription.

Inputs: id (required), name, state, amount, +9 more.

payments_versionB

Get Payments (Platby) module API version.

Inputs: no named parameters.

public_eventsA

List public school events in a time range. Uses legacy -login.edookit.net base URL. No authentication required.

Inputs: to (required), from (required), ical.

student_personal_dataB

Get personal data of students as of a reference date.

Inputs: date, include_inactive_since.

student_statisticsA

Get pseudonymized (anonymous UUID) student statistics across entire school history.

Inputs: date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 46 tools

    Disambiguation2/5

    Many tools are module-prefixed, but several clusters are hard to distinguish: lessons_list, attendance_daily_schedule, direct_attendance_lessons, and changed_timetable all serve timetable-ish purposes. payments_types and payments_categories are nearly indistinguishable from their descriptions, and person_search, student_personal_data, and attendance_students overlap around person data.

    Naming Consistency3/5

    Snake_case and module prefixes are reasonably consistent, but verb usage is not: read endpoints appear as bare nouns (attendance_students), list_* (lessons_list), and *_by_date (attendance_passages_by_date). Create operations mix insert_ and create_, and a few tools like person_search and changed_timetable break the module_prefix pattern.

    Tool Count2/5

    At 46 tools, this is far above the 25-tool threshold and will be difficult for agents to navigate efficiently. The breadth is partly justified by multiple modules, but many tools are trivial version or reference-data endpoints that could be consolidated or removed.

    Completeness3/5

    Payments has solid CRUD coverage, and attendance includes reading, inserting, and excuse workflows. However, attendance passages and attendance records are insert/read-only with no update/delete, and lessons, courses, evaluations, and individual goals are mostly read-only or single-purpose, leaving notable lifecycle gaps.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables parents and students to interact with the Edookit school portal through MCP, including viewing grades, assignments, timetables, attendance, messages, payments, and more, as well as submitting absence excuses and sending messages.
      21
      1
      ISC
    • 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to retrieve and work with Moscow Electronic School data, including schedules, homework, grades, rankings, school info, meals, passes, olympiads, and portfolio, via authenticated MCP tools.
      MIT