Skip to main content
Glama

studentvue-mcp

An MCP 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?"

Related MCP server: google-classroom-student-mcp

Setup

You need Node.js 18 or newer.

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:

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

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):

{
  "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

Available Tools

3 tools
studentvue_classOne classA
Read-only

One class's assignments from the grade book, with scores, due dates and categories (missing work is marked). Give part of the class name, e.g. 'CALCULUS'. Read-only.

Inputs: class (required).

studentvue_gradebookGrade bookA
Read-only

StudentVue grade book: every class with its current grade and percentage, missing assignments count and last update. Read-only.

Inputs: no named parameters.

studentvue_pageOther pagesA
Read-only

Another StudentVue page as text: attendance, schedule, calendar, report_card, messages or student (student info). Read-only.

Inputs: page (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to access a local, read-only snapshot of ParentVUE gradebook data, including students, courses, assignments, and missing work, so users can ask questions like what assignments are missing this week.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.
      36 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to read a student's PowerSchool guardian portal in a strictly read-only way, including current grades, assignments and missing work, attendance, schedule, grade history, teacher comments, what-if grade calculations, and estimated GPA.
      11
      GPL 3.0