Skip to main content
Glama
README.md
# studentvue-mcp

An [MCP](https://modelcontextprotocol.io) server that lets AI assistants like Claude read your **StudentVue** grades, assignments, attendance and schedule.

It works through the regular StudentVue **student website** with a headless browser, so it keeps working in districts that switched off the old StudentVue app API. It's **read-only**: it signs in and reads pages, and never submits, sends or changes anything.

## What your assistant can do

| Tool | What it returns |
|---|---|
| `studentvue_gradebook` | Every class with its current grade and percentage, how many assignments are missing, and when it was last updated |
| `studentvue_class` | One class's assignments with scores, due dates and categories, with missing work marked (give part of the class name, like `calculus`) |
| `studentvue_page` | Attendance, class schedule, calendar, report card, messages, or student info, as text |

Ask things like *"What's my grade in Calculus?"*, *"Am I missing any assignments?"* or *"What's my schedule tomorrow?"*

## Setup

You need [Node.js](https://nodejs.org) 18 or newer.

```bash
git clone https://github.com/coolcrazycid/studentvue-mcp.git
cd studentvue-mcp
npm install          # also downloads a small headless Chromium for Playwright
```

Check that your login works. This signs in and prints your grade book:

```bash
STUDENTVUE_URL="https://xx-yyy-psv.edupoint.com" \
STUDENTVUE_USERNAME="your-username" \
STUDENTVUE_PASSWORD="your-password" \
npm run check
```

`STUDENTVUE_URL` is the address where you sign in to StudentVue in a browser (only the `https://….edupoint.com` part matters).

### Claude Code

```bash
claude mcp add studentvue \
  -e STUDENTVUE_URL="https://xx-yyy-psv.edupoint.com" \
  -e STUDENTVUE_USERNAME="your-username" \
  -e STUDENTVUE_PASSWORD="your-password" \
  -- node /full/path/to/studentvue-mcp/src/index.js
```

### Claude Desktop (or any MCP client)

Add this to your MCP config (for Claude Desktop: Settings › Developer › Edit Config):

```json
{
  "mcpServers": {
    "studentvue": {
      "command": "node",
      "args": ["/full/path/to/studentvue-mcp/src/index.js"],
      "env": {
        "STUDENTVUE_URL": "https://xx-yyy-psv.edupoint.com",
        "STUDENTVUE_USERNAME": "your-username",
        "STUDENTVUE_PASSWORD": "your-password"
      }
    }
  }
}
```

### Options

| Variable | Meaning |
|---|---|
| `STUDENTVUE_BROWSER=chrome` | Use your installed Google Chrome instead of Playwright's Chromium |
| `STUDENTVUE_HEADLESS=0` | Show the browser window (for troubleshooting) |

## How it works

StudentVue sessions expire after about 20 minutes, so the server signs in with your username and password the way the login page does, and signs in again whenever the session has ended. Then it opens the page you asked for in a headless browser and returns its text, without the site's menus. For one class's details it opens the grade book and clicks the class name, which is the only thing it ever clicks.

Your password stays in your MCP config on your computer. It's only sent to your district's StudentVue site, and never to the AI. The AI only sees the page text.

## Notes

- StudentVue is made by Edupoint (Synergy). This project isn't affiliated with or endorsed by Edupoint or any school district. Use it only with your own account, and follow your school's rules.
- If your district changes its StudentVue site, the page text may change. Please open an issue.

## License

MIT

TDQS

A3.8/5.0

Scored across 3 tools

Disambiguation4/5

The three tools map to distinct levels: whole-gradebook overview, single-class assignment detail, and other pages (attendance, schedule, calendar, report card, messages, student info). The only mild risk is that studentvue_page is a catch-all whose enumerated options could overlap with the other two (e.g. schedule vs. gradebook), but the descriptions clearly bound each tool.

Naming Consistency5/5

All three tools follow the identical studentvue_<noun> pattern with a shared server prefix and no mixing of verb styles or casing. Fully predictable.

Tool Count4/5

Three tools is on the lean side but fits a deliberately read-only portal wrapper; each tool earns its place by covering a different granularity. A slightly richer surface (e.g. a dedicated assignment-lookup) would round it out.

Completeness4/5

Gradebook, per-class assignments, and a page reader covering attendance, schedule, calendar, report card, messages and student info give broad read-only coverage. Minor gaps: no direct document/report-card file retrieval and no write operations (e.g. messaging), though the latter may be out of scope.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues