PluginBench
MCP Server

io.github.tixuz/openemis MCP Server

io.github.tixuz/openemis

RepositoryRegistry

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.

Claude Desktop
~/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>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.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>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "openemis": {
      "type": "stdio",
      "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>"
      }
    }
  }
}
Claude Code
claude mcp add openemis --env OPENEMIS_BASE_URL=<YOUR_OPENEMIS_BASE_URL> --env OPENEMIS_USERNAME=<YOUR_OPENEMIS_USERNAME> --env OPENEMIS_PASSWORD=<YOUR_OPENEMIS_PASSWORD> --env OPENEMIS_API_KEY=<YOUR_OPENEMIS_API_KEY> --env OPENEMIS_TIMEOUT_MS=<YOUR_OPENEMIS_TIMEOUT_MS> --env OPENEMIS_LOG_VERBOSE=<YOUR_OPENEMIS_LOG_VERBOSE> --env OPENEMIS_LOG_FILE=<YOUR_OPENEMIS_LOG_FILE> -- npx -y openemis-mcp

Related MCP servers

io.github.tixuz/openemis-pro

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

View repository →