Skip to main content
Glama

il-school-mcp

Local-first, read-only agentic plugin & MCP server for Israeli school portals (Mashov / משו״ב and Webtop / SmartSchool), packaged to install cleanly in Claude, Antigravity, and ChatGPT / Codex.

Features

  • Cross-Platform Plugin Structure: Includes native manifests and skills for Claude Code / Marketplace (.claude-plugin/ + .mcp.json), Claude Desktop (manifest.json), Antigravity (.antigravity-plugin/ + mcp_config.json + rules/AGENTS.md), and ChatGPT / OpenAI Agent Plugins & Codex (plugin.json + mcp.json + .codex-plugin/), sharing portable skills/.

  • Zero-Redundant-Login Session Store: Persists Mashov (X-Csrf-Token + cookies) and Webtop (webToken) sessions for 12 hours, re-authenticates once on expiration, and enforces a 30-minute / 2-hour circuit breaker on failures so parents don't get spammed with login SMS alerts.

  • Multi-Account & Auto-Discovery: Supports any combination of Mashov and Webtop parent/student accounts and automatically discovers linked children, grades, and classes.

  • Smart Enrichment:

    • Infers missing homework due dates from the child's weekly timetable (skipping Shabbat).

    • Classifies behavior & attendance events (positive, negative, attendance, note).

    • Downloads and extracts text from .pdf and .docx message attachments and links study materials to upcoming exams.

    • Optional per-student public Google Exam Calendar .ics filtering by grade, class, and tracks.


Related MCP server: Librus Read-only MCP

Installing as a Plugin

1. Claude (Claude Desktop App, Cowork & Claude Code)

  • Claude Desktop Chat (1-Click Desktop Extension .mcpb — Recommended for non-developers): Regular Claude Desktop Chat does not run .mcp.json stdio servers from GitHub marketplace plugins (it only syncs their SKILL.mds). Instead, download il-school-mcp.mcpb from GitHub Releases and open/drop it in Claude Desktop → Settings → Extensions. Claude Desktop will prompt you for Mashov/Webtop credentials directly in a native GUI form on install.

  • Claude Code / Cowork (GitHub marketplace):

    /plugin marketplace add hagaija/il-school-mcp
    /plugin install il-school@il-school-marketplace

    (On first question, Claude will provide a http://127.0.0.1:... setup link via school_open_setup if no accounts are configured yet.)

  • Manual MCP entry (claude_desktop_config.json):

    {
      "mcpServers": {
        "il-school": {
          "command": "node",
          "args": ["/ABS/PATH/TO/il-school-mcp/bundle/server.cjs"]
        }
      }
    }

2. Antigravity

Clone and install directly via CLI:

git clone https://github.com/hagaija/il-school-mcp.git
agy plugin install ./il-school-mcp

Restart Antigravity after installing a new plugin directory, then ask one of the starter prompts or invoke /il-school-assistant / /il-school-setup.

3. ChatGPT / OpenAI Agent Plugins & Codex

  • Codex / Agent Plugin marketplace: Uses root plugin.json + mcp.json, .agents/plugins/marketplace.json, and .codex-plugin/plugin.json + .mcp.json:

    codex marketplace add hagaija/il-school-mcp

    Or manually in ~/.codex/config.toml:

    [mcp_servers.il-school]
    command = "node"
    args = ["/ABS/PATH/TO/il-school-mcp/scripts/launch-mcp.mjs"]
  • Standard ChatGPT Desktop chat mode: Requires a remote HTTPS MCP endpoint. Run the built-in Streamable HTTP server locally with a bearer token and expose it privately over Tailscale Funnel or Cloudflare Tunnel:

    node /ABS/PATH/TO/il-school-mcp/dist/index.js --http --port 3333 --token "your-secret-token"

    Endpoint: https://<your-tunnel-host>/mcp


First-Time Setup & Modifying Config

Credentials are kept strictly local in ~/.config/il-school-mcp/config.json (0600) and are never entered into LLM chat.

node scripts/launch-mcp.mjs setup
  • On first run (no config yet): Launches the onboarding flow to search Mashov schools by name (or enter semel), add Mashov/Webtop credentials, test login live, and show discovered students.

  • When run again: Opens a reconfiguration menu to add, edit (update password/semel/label), or remove accounts, configure student overrides (nicknames, aliases, exam .ics calendar URLs, tracks), and adjust general settings (timezone, cache TTL, quiet hours, attachment downloads).

Verify connectivity anytime:

node scripts/launch-mcp.mjs doctor

Bundled Skills & Agent Guide

  • AGENTS.md: Instructions for running, configuring, and testing the MCP server.

  • skills/il-school-assistant/SKILL.md: Daily briefings, schedules, homework, exam prep, and behavior reporting rules.

  • skills/il-school-setup/SKILL.md: First-time onboarding & reconfiguration workflow when needsSetup: true is detected.

  • rules/AGENTS.md: Always-on Antigravity plugin rules.

Available MCP Tools

  1. school_list_students — Lists auto-discovered children, classes, and portals (or needsSetup: true before initial setup).

  2. school_get_schedule — Timetable for today, tomorrow, weekday name, YYYY-MM-DD, or week.

  3. school_get_homework — Homework assignments (with dueDateInferred estimation).

  4. school_get_behavior — Behavior & attendance events (positive, negative, attendance, note).

  5. school_get_exams — Upcoming exams + linked study materials (provided vs. missing).

  6. school_get_messages — School inbox messages + extracted PDF/DOCX attachment text.

  7. school_get_digest — Consolidated daily/tomorrow family briefing.

  8. school_open_setup — Opens a local 127.0.0.1 browser setup page so GUI users can configure or edit Mashov/Webtop accounts without using a terminal or sharing passwords in chat.


Acknowledgments, Disclaimer & License

  • Credits: Webtop (SmartSchool) API endpoint integration was informed by Tomer Klein's open-source pywebtop (MIT License) as well as community-documented Mashov API conventions.

  • Disclaimer: This project is an unofficial, independent read-only client and is not affiliated with, endorsed by, or supported by Mashov or SmartSchool/Webtop.

  • License: MIT © 2026 Hagai Jacobson.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the Mashov school management system API, allowing retrieval of grades, schedule, messages, and more through natural language.
      3
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Provides read-only access to Librus parent account data for multiple children, enabling retrieval of grades, attendance, timetable, calendar, homework, announcements, messages, and attachments via MCP.
      11
      1
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables natural-language queries across multiple schools' Canvas and Blackboard accounts for courses, notifications, assignments, grades, feedback, and schedules, with read-only access and local todo/calendar export.
      9
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Connects AI assistants and agents to Finland's school system, enabling retrieval of schedules, homework, exams, grades, messages, absences, and related school information for all of a family's children across multiple accounts. It runs locally, logs in only to the school service, and cannot send messages or change data.
      2
      20
      89
      MIT