# infinitecampus-mcp

infinitecampus-mcp is an MCP server for Claude Code that lets an agent access grades, attendance, and assignments in Infinite Campus. It can also retrieve schedules, messages, and documents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: chrischall
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chrischall/infinitecampus-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/infinitecampus-mcp

## What it does

The server connects an agent to a Campus Parent account and exposes tools for school records, including grades, attendance, schedules, messages, and documents. It discovers linked districts after sign-in through CUPS SSO. Separate Infinite Campus instances with different credentials need separate server instances.

For authentication, set `IC_BASE_URL`, `IC_DISTRICT`, `IC_USERNAME`, and `IC_PASSWORD`. Another route uses `IC_BASE_URL` and `IC_DISTRICT` with the ContextMint Bridge extension for Chrome; sign in to the school portal, and the server reads session data from the browser. The connection needs either configured credentials or that extension. On a local setup, document downloads go to `IC_DOWNLOAD_DIR`, or to `~/Downloads` when that variable is unset.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `IC_BASE_URL`, `IC_DISTRICT`, `IC_USERNAME`, `IC_PASSWORD`, `IC_NAME`, `IC_DISABLE_FETCHPROXY`, `IC_SESSION_CACHE`, `IC_SESSION_FILE`, `IC_DOWNLOAD_DIR`, `FETCHPROXY_WS_PORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env IC_BASE_URL=<IC_BASE_URL> --env IC_DISTRICT=<IC_DISTRICT> --env IC_USERNAME=<IC_USERNAME> --env IC_PASSWORD=<IC_PASSWORD> --env IC_NAME=<IC_NAME> --transport stdio infinitecampus-mcp -- npx -y infinitecampus-mcp
```
Replace <…> with your own values. 7 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add infinitecampus-mcp --env IC_BASE_URL=<IC_BASE_URL> --env IC_DISTRICT=<IC_DISTRICT> --env IC_USERNAME=<IC_USERNAME> --env IC_PASSWORD=<IC_PASSWORD> --env IC_NAME=<IC_NAME> -- npx -y infinitecampus-mcp
```
Replace <…> with your own values. 7 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "infinitecampus-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "infinitecampus-mcp"
            ],
            "env": {
                "IC_BASE_URL": "<IC_BASE_URL>",
                "IC_DISTRICT": "<IC_DISTRICT>",
                "IC_USERNAME": "<IC_USERNAME>",
                "IC_PASSWORD": "<IC_PASSWORD>",
                "IC_NAME": "<IC_NAME>"
            }
        }
    }
}
```
Replace <…> with your own values. 7 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "infinitecampus-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "infinitecampus-mcp"
            ],
            "env": {
                "IC_BASE_URL": "<IC_BASE_URL>",
                "IC_DISTRICT": "<IC_DISTRICT>",
                "IC_USERNAME": "<IC_USERNAME>",
                "IC_PASSWORD": "<IC_PASSWORD>",
                "IC_NAME": "<IC_NAME>"
            }
        }
    }
}
```
Replace <…> with your own values. 7 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e IC_BASE_URL=<IC_BASE_URL> -e IC_DISTRICT=<IC_DISTRICT> -e IC_USERNAME=<IC_USERNAME> -e IC_PASSWORD=<IC_PASSWORD> -e IC_NAME=<IC_NAME> infinitecampus-mcp npx -y infinitecampus-mcp
```
Replace <…> with your own values. 7 more environment variables are in the server README

## When to use it
- retrieve a student's grades
- check attendance by course
- find assignments and due dates
- look up schedules and school messages
- download a Campus Parent document

## Example prompts
- Show the student's recent grades.
- Check attendance and attendance events for this period.
- Find assignments and messages in Campus Parent.

## Similar
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [discover-analytics-patterns](https://affpapa.org/en/nevibecode/skills/discover-analytics-patterns.md) — skill · 66000 installs
- [add-analytics-instrumentation](https://affpapa.org/en/nevibecode/skills/add-analytics-instrumentation.md) — skill · 66000 installs
- [convex-expert](https://affpapa.org/en/nevibecode/skills/convex-expert.md) — skill · 44200 installs
- [convex-migrate](https://affpapa.org/en/nevibecode/skills/convex-migrate.md) — skill · 44100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
