infinitecampus-mcp
MCP server for Infinite Campus (Campus Parent portal). Single-account config — linked districts are auto-discovered via CUPS SSO after login.
Tools
19 tools across academics, daily life, documents, messaging, and feature discovery.
| Domain | Tools |
|---|
| Districts | ic_list_districts |
| Students | ic_list_students |
| Schedule | ic_get_schedule |
| Assignments | ic_list_assignments (sectionID server-side; missingOnly / date filters client-side) |
| Grades | ic_list_grades, ic_list_recent_grades (default 14d window) |
| School calendar | ic_list_school_days |
| Attendance | ic_list_attendance (per-course summary), ic_list_attendance_events (individual events with codes + comments) |
| Behavior | ic_list_behavior (FeatureDisabled-aware) |
| Food service | ic_list_food_service (FeatureDisabled-aware) |
| Documents | ic_list_documents, ic_download_document |
| Messaging | ic_list_messages (3 sources: prism notifications + Messenger 2.0 inbox + portal announcements), ic_get_message (fetch parsed HTML body of an inbox message) |
| Teachers | ic_list_teachers (teachers per section + assigned counselors) |
| Assessments | ic_list_assessments (standardized test scores) |
| Fees | ic_list_fees (assignments + surplus balance) |
| Features | ic_get_features (per-enrollment displayOptions flags) |
Tools that the harness will gate as write/IO operations: ic_download_document.
Configuration
infinitecampus-mcp tries two auth paths in priority order; whichever succeeds first is used. Existing setups keep working unchanged.
- Env-var credentials (legacy). Set all four:
IC_BASE_URL=https://campus.springfield.k12.example.us
IC_DISTRICT=springfield
IC_USERNAME=parent@example.com
IC_PASSWORD=...
IC_NAME=Springfield # optional, defaults to IC_DISTRICT
- fetchproxy fallback (no password needed). Set only
IC_BASE_URL + IC_DISTRICT (still required so the MCP knows which host to talk to and which district to dispatch on), then install the fetchproxy 0.3.0 extension (Chrome Web Store / Safari .dmg) and sign into your IC portal once. The MCP reads the JSESSIONID (HttpOnly) + XSRF-TOKEN cookies on startup and goes direct-to-API from Node thereafter — the extension is not in the request hot path.
Set IC_DISABLE_FETCHPROXY=1 to opt out of the fallback (turns missing credentials into a hard error — useful in headless CI).
Linked districts (via CUPS SSO) are auto-discovered after primary login — a parent with kids in two districts only configures the primary. No extra config needed. If you have truly separate IC instances with different credentials, run two MCP instances.
See .env.example.
Status
Unofficial — not affiliated with Infinite Campus. AI-maintained.
Acknowledgement of Terms
By using this MCP server, you acknowledge and agree to the following:
1. This server accesses your own Campus Parent account. Auth happens via your own credentials, scoped to the student records your school district has authorized you to view. It does not — and cannot — access anyone else's student records.
2. Infinite Campus's Terms of Use govern your use of this server, just as they govern your direct use of Campus Parent. The clauses most relevant here:
Users may not access, use, or search the Services by any means other than our publicly supported interfaces (for example, scraping or using the content to train artificial intelligence software).
And: "You are responsible for safeguarding the password that you use to access the Service and you agree not to disclose your password to any third party."
You are agreeing to those terms — read by the maintainer 2026-05-23 — every time you invoke a tool in this server. This server uses Infinite Campus's mobile-app JSON endpoints (/campus/api/oneRosterCampus, /portal/api/...) which are not "publicly supported interfaces" — IC may treat this as a ToS violation.
3. Personal, parent/student use only. This project is not affiliated with, endorsed by, sponsored by, or in partnership with Infinite Campus, Inc. or any school district. It is a personal automation tool for an authorized Campus Parent / Campus Student user to read their own (or their student's) records. Do not use it to bulk-extract student data, share another family's grades, or train AI models on student records.
