io.github.tixuz/openemis MCP Server

io.github.tixuz/openemis

Repository Registry

What is the io.github.tixuz/openemis MCP server?

Read-only MCP server for OpenEMIS — free open-source school management system. 675 resources.

How to install io.github.tixuz/openemis

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

OPENEMIS_BASE_URL
required
Base URL of your OpenEMIS instance (e.g., https://demo.openemis.org/core)
OPENEMIS_USERNAME
required
OpenEMIS login username
OPENEMIS_PASSWORD
required
secret
OpenEMIS login password
OPENEMIS_API_KEY
required
secret
OpenEMIS API key (issued by the OpenEMIS admin)
OPENEMIS_TIMEOUT_MS
Request timeout in milliseconds (default 30000)
OPENEMIS_LOG_VERBOSE
Set to 1 to log every tool call and result as JSONL. OFF by default. Results contain tenant PII — enable only on instances you own.
OPENEMIS_LOG_FILE
Path to write verbose JSONL log. If empty and OPENEMIS_LOG_VERBOSE=1, logs go to stderr.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openemis": {
      "command": "npx",
      "args": [
        "-y",
        "openemis-mcp"
      ],
      "env": {
        "OPENEMIS_BASE_URL": "<YOUR_OPENEMIS_BASE_URL>",
        "OPENEMIS_USERNAME": "<YOUR_OPENEMIS_USERNAME>",
        "OPENEMIS_PASSWORD": "<YOUR_OPENEMIS_PASSWORD>",
        "OPENEMIS_API_KEY": "<YOUR_OPENEMIS_API_KEY>",
        "OPENEMIS_TIMEOUT_MS": "<YOUR_OPENEMIS_TIMEOUT_MS>",
        "OPENEMIS_LOG_VERBOSE": "<YOUR_OPENEMIS_LOG_VERBOSE>",
        "OPENEMIS_LOG_FILE": "<YOUR_OPENEMIS_LOG_FILE>"
      }
    }
  }
}