studentvue-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@studentvue-mcp What's my grade in Calculus and am I missing any assignments?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Every class with its current grade and percentage, how many assignments are missing, and when it was last updated |
| One class's assignments with scores, due dates and categories, with missing work marked (give part of the class name, like |
| 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 PlaywrightCheck 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 checkSTUDENTVUE_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.jsClaude 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 |
| Use your installed Google Chrome instead of Playwright's Chromium |
| 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 toolsstudentvue_classOne classARead-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 bookARead-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 pagesARead-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
Scored across 3 tools
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.
All three tools follow the identical studentvue_<noun> pattern with a shared server prefix and no mixing of verb styles or casing. Fully predictable.
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.
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
Related MCP Connectors
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Connect AI agents to your own Chrome with scoped access, approvals, and verified task results.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseAqualityBmaintenanceLets AI apps read a student's Google Classroom data, including active classes, to-do and missing assignments, upcoming due dates, grades on returned work, and announcements. It is read-only, so it can never turn in, edit, or delete anything.14238 npmMIT
- AlicenseNot gradedqualityCmaintenanceLets 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 npm1MIT
- AlicenseAqualityBmaintenanceEnables 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.11GPL 3.0