edookit-mcp
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-mcp What's the timetable for class 8A today?"
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-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 |
| Service version (public, no auth) |
| Current school year and semester |
| List classes; optional |
| Schedule groups and courses |
| Staff job classification codebook |
| Teaching period time ranges |
| All staff including RFID card numbers |
| All students including guardian contacts and RFID cards |
| Daily schedule for a person on a date |
| All RFID passages on a date |
| Single passage by ID |
| Record a new RFID entry/exit event |
Lessons / Hodiny
Tool | Description |
| API version |
| Timetable for a day; filters by course, room, teacher, student, class |
| All rooms |
| All course types |
| All work/activity types |
People
Tool | Description |
| Search by Edookit ID or Plus4U ID; returns roles, children, representatives |
| Student personal data as of a reference date |
| Employee personal data as of a reference date |
| Pseudonymized student statistics (no names, anonymous UUID) |
Grades / Hodnocení
Tool | Description |
| List evaluations filtered by student, course, or evaluation term |
Payments / Platby
Tool | Description |
| API version |
| Payment categories |
| Available currencies |
| Configured bank accounts |
| Payment types |
| Organizations |
| List prescriptions with filters |
| Create a prescription with optional per-person overrides |
| Record a payment transaction |
| Update a prescription |
| Delete a prescription or remove persons from it |
| Update a payment record |
| Delete a payment record |
Courses / Kurzy
Tool | Description |
| API version |
| Students with courses, lessons, final evaluations, and attendance % |
Timetable
Tool | Description |
| Public school events in a date range (no auth required) |
| Substitution schedule — only lessons that changed vs original |
Direct Attendance / Přímý zápis docházky
Tool | Description |
| Lesson overview for a student on a day |
| Submit a future absence notice (avízo) |
| Submit a current excuse (omluvenka) |
| Insert an attendance record with optional status/minutes |
| Full attendance history for a student |
Individual Goals / Individuální cíle
Tool | Description |
| Individual lesson content per student |
| Learning agreements with coach feedback and subcompetences |
Notes
All dates use
YYYY-MM-DDformat unless noted otherwise.Person IDs are unique within one Edookit instance but not across different schools.
public_eventsandchanged_timetableuse the legacy-login.edookit.netbase 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 buildAvailable Tools
46 toolsattendance_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.
person_searchB
Search for a person by Edookit ID or Plus4U ID. Returns person data including roles, children, and representatives.
Inputs: searchCriterion (required).
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
Scored across 46 tools
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.
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.
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.
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
Related MCP Connectors
MCP adapter for the Paxaver school community platform. Streamable HTTP, OAuth 2.1, capability auth.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
MCP server providing attendance data queries via the CloudTime API.
Manage Timequip projects, tasks, comments, members, and dashboards through MCP.
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
- AlicenseBqualityBmaintenanceEnables 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.211ISC
- 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
- AlicenseNot gradedqualityCmaintenanceEnables 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