il-school-mcp
Supports optional per-student public Google Exam Calendar .ics feeds, allowing exam filtering by grade, class, and tracks.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 portableskills/.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
.pdfand.docxmessage attachments and links study materials to upcoming exams.Optional per-student public Google Exam Calendar
.icsfiltering 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.jsonstdioservers from GitHub marketplace plugins (it only syncs theirSKILL.mds). Instead, downloadil-school-mcp.mcpbfrom 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 viaschool_open_setupif 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-mcpRestart 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-mcpOr 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 setupOn 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.icscalendar URLs, tracks), and adjust general settings (timezone, cache TTL, quiet hours, attachment downloads).
Verify connectivity anytime:
node scripts/launch-mcp.mjs doctorBundled 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 whenneedsSetup: trueis detected.rules/AGENTS.md: Always-on Antigravity plugin rules.
Available MCP Tools
school_list_students— Lists auto-discovered children, classes, and portals (orneedsSetup: truebefore initial setup).school_get_schedule— Timetable fortoday,tomorrow, weekday name,YYYY-MM-DD, orweek.school_get_homework— Homework assignments (withdueDateInferredestimation).school_get_behavior— Behavior & attendance events (positive,negative,attendance,note).school_get_exams— Upcoming exams + linked study materials (providedvs.missing).school_get_messages— School inbox messages + extracted PDF/DOCX attachment text.school_get_digest— Consolidated daily/tomorrow family briefing.school_open_setup— Opens a local127.0.0.1browser 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Read students, classes, grades, assignments, attendance and households in Veracross.
Read students, rolls and attendance; create and update students, contacts and houses in Orah.
Read pupils, routes, bus positions, trips, boarding lists and incidents in SchoolBusTrack.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the Mashov school management system API, allowing retrieval of grades, schedule, messages, and more through natural language.3MIT
- FlicenseAqualityBmaintenanceProvides 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.111-
- AlicenseNot gradedqualityBmaintenanceEnables 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.9MIT
- AlicenseAqualityAmaintenanceConnects 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.22089MIT