
Openemis Pro
Bridges Claude and other MCP clients to OpenEMIS, the UNESCO-backed open-source school management system used by kindergartens, primary schools, and universities worldwide. Wraps 675 resources and 3,355 REST endpoints behind nine high-level tools: health checks, domain discovery, playbook retrieval, and full CRUD operations (read, create, update, delete). The `openemis_get` tool handles filtered queries across students, staff, attendance, exams, and infrastructure using CakePHP-style parameters. Write operations work for non-workflow resources; workflow-controlled entities like staff leave redirect to curated playbooks. Tested against Core 5.10.0 and the public demo instance at demo.openemis.org. Includes per-user authentication and supports both stdio and HTTP server modes for ChatGPT Custom GPT integration.
- GitHub stars
- 1
- tools
- 9
- auth
- Secret needed
- transport
- STDIO
- env vars
- 6
- last updated
- May 15, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
openemis_healthPings the configured instance and reports reachability. Performs a real login round-trip — if this passes, CRUD will work.
Pings the configured instance and reports reachability. Performs a real login round-trip — if this passes, CRUD will work.
No parameter schema in public metadata yet.
openemis_list_domainsLists the curated OpenEMIS domains — Attendance, Assessment, Staff, Student, Institution, Schedule, Examination, Report — each with a one-line summary.
Lists the curated OpenEMIS domains — Attendance, Assessment, Staff, Student, Institution, Schedule, Examination, Report — each with a one-line summary.
No parameter schema in public metadata yet.
openemis_discoverInput: a topic string. Output: up to 30 endpoints relevant to that topic, drawn from the domain knowledge pack and the per-instance manifest.
Input: a topic string. Output: up to 30 endpoints relevant to that topic, drawn from the domain knowledge pack and the per-instance manifest.
No parameter schema in public metadata yet.
openemis_list_playbooksLists all 40 curated workflow playbooks with id, title, domain, and audience.
Lists all 40 curated workflow playbooks with id, title, domain, and audience.
No parameter schema in public metadata yet.
openemis_get_playbookInput: a playbook id. Output: the full playbook — resources, ordered steps, guidance notes, and example queries.
Input: a playbook id. Output: the full playbook — resources, ordered steps, guidance notes, and example queries.
No parameter schema in public metadata yet.
openemis_getUnified read tool. { resource, id?, params? } — if id is present, fetches the singleton; otherwise lists with any combination of _fields, _conditions, orderby, order, page, limit, plus any ad-hoc filter key.
Unified read tool. { resource, id?, params? } — if id is present, fetches the singleton; otherwise lists with any combination of _fields, _conditions, orderby, order, page, limit, plus any ad-hoc filter key.
No parameter schema in public metadata yet.
openemis_createCreate a new record. { resource, body } — non-workflow resources only.
Create a new record. { resource, body } — non-workflow resources only.
No parameter schema in public metadata yet.
openemis_updateUpdate an existing record by id. { resource, id, body } — non-workflow resources only.
Update an existing record by id. { resource, id, body } — non-workflow resources only.
No parameter schema in public metadata yet.
openemis_deleteDelete a record by id. { resource, id } — non-workflow resources only.
Delete a record by id. { resource, id } — non-workflow resources only.
No parameter schema in public metadata yet.
Sponsors
Configuration
OPENEMIS_BASE_URL*Base URL of your OpenEMIS instance (e.g., https://demo.openemis.org/core)
OPENEMIS_API_KEY*secretOpenEMIS API key (issued by the OpenEMIS admin). Required for every upstream login.
OPENEMIS_USERNAMEOpenEMIS login username. Optional — if unset, server fails closed and requires openemis_login at runtime.
OPENEMIS_PASSWORDsecretOpenEMIS login password. Pairs with OPENEMIS_USERNAME for env-default auth.
OPENEMIS_TIMEOUT_MSRequest timeout in milliseconds (default 30000)
OPENEMIS_CORE_IN_OPERATORSet to 1 to enable native IN-operator batch GETs once your OpenEMIS Core has POCOR-9660 deployed.
Readme
openemis-mcp-pro logo — read and write AI bridge for OpenEMIS school management
openemis-mcp-pro — Read + Write AI Bridge for OpenEMIS School Management
A natural-language bridge between MCP-aware agents (Claude, Codex, Cursor, etc.) and any OpenEMIS school — with full read + write access.
OpenEMIS is a free, open-source school management information system developed by UNESCO and KORDIT. It runs the day-to-day administration of every kind of educational institution — kindergartens, primary schools, secondary schools, secondary vocational institutions, technical colleges, and universities — managing students, staff, attendance, assessment, infrastructure, meals, scholarships, examinations, training, and ministry-level reporting. This MCP-pro server adds full read + write access plus per-user authentication on top of any OpenEMIS school.
Translations: Русский · Español · हिन्दी · العربية
Details
- Repository
- github.com/tixuz/openemis-mcp-pro
- Package
openemis-mcp-pro- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active