schoology-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., "@schoology-mcp What assignments do I have due this week?"
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.
schoology-mcp
An MCP server that lets AI assistants like Claude read your Schoology: what's due, what's overdue, upcoming events, your courses and their materials.
It needs no API key. Students usually can't get Schoology API keys, so it works through the website with your own sign-in instead (including "Sign in with Google" or your school's single sign-on). It's read-only: it loads pages and the site's own read-only data, and never submits, posts or changes anything.
What your assistant can do
Tool | What it returns |
| Upcoming assignments with due dates, overdue assignments, and upcoming events across all your courses |
| Your current courses |
| One course's materials page (folders, assignments, files, posts) as text (give part of the course name, like |
Ask things like "What's due this week?", "Do I have anything overdue?" or "What's in this week's folder for AP Physics?"
Many districts keep grades in a separate student information system. If yours uses StudentVue, see studentvue-mcp.
Related MCP server: Canvas MCP for students
Setup
You need Node.js 18 or newer, plus Google Chrome, Microsoft Edge, Brave or Chromium for signing in.
git clone https://github.com/coolcrazycid/schoology-mcp.git
cd schoology-mcp
npm install # also downloads a small headless Chromium for Playwright1. Sign in once. This opens a normal browser window. Sign in to Schoology the way you usually do. The window closes by itself when you're in, and your session is saved in ~/.schoology-mcp/.
SCHOOLOGY_DOMAIN="yourschool.schoology.com" npm run login2. Check that it works:
SCHOOLOGY_DOMAIN="yourschool.schoology.com" npm run checkClaude Code
claude mcp add schoology \
-e SCHOOLOGY_DOMAIN="yourschool.schoology.com" \
-e SCHOOLOGY_EMAIL="you@yourschool.org" \
-- node /full/path/to/schoology-mcp/src/index.jsClaude Desktop (or any MCP client)
{
"mcpServers": {
"schoology": {
"command": "node",
"args": ["/full/path/to/schoology-mcp/src/index.js"],
"env": {
"SCHOOLOGY_DOMAIN": "yourschool.schoology.com",
"SCHOOLOGY_EMAIL": "you@yourschool.org"
}
}
}
}Options
Variable | Meaning |
| Your Schoology address, like |
| Your school account's email, so the server can pick it if Google asks "Choose an account" (optional) |
| Read with your installed Chrome instead of Playwright's Chromium |
| The browser to sign in with, if it isn't found automatically |
| Where the session is saved (default |
How it works
Signing in:
loginopens a regular browser window (not an automated one, so Google sign-in isn't blocked) with its own profile in~/.schoology-mcp/login-profile. Once Schoology's own data loads, the session cookies are saved to~/.schoology-mcp/session.json, readable only by you.Reading: the server loads that session into a headless browser and reads Schoology's home-page feeds (upcoming, overdue, events), your course list, and course pages.
Staying signed in: when Schoology ends the session, the server opens your school's sign-in page in the background. If Google just asks which account to use, it picks yours. If it needs your password again, it asks you to run
loginagain.
Your sign-in never goes to the AI. It only sees the text of the pages. Delete ~/.schoology-mcp at any time to sign out.
Notes
Schoology is a product of PowerSchool. This project isn't affiliated with or endorsed by PowerSchool or any school. Use it only with your own account, and follow your school's rules.
Schools can customize Schoology, and the site changes now and then. If something stops working, please open an issue.
License
MIT
Available Tools
3 toolsschoology_courseCourse materialsARead-only
A course's materials page (folders, assignments, files, posts) as text. Give part of the course name. Read-only.
Inputs: course (required).
schoology_coursesCoursesCRead-only
The student's current Schoology courses. Read-only.
Inputs: no named parameters.
schoology_upcomingUpcoming and overdueARead-only
Schoology: upcoming assignments with due dates, overdue assignments, and upcoming events across all courses. Read-only.
Inputs: no named parameters.
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 cover distinct retrieval targets: aggregated upcoming work, the course list, and a single course's materials. The only potential confusion is between schoology_courses (list) and schoology_course (detail), but the descriptions make the singular/plural distinction reasonably clear.
All tools share a consistent schoology_ prefix and snake_case naming, which is predictable. schoology_upcoming is slightly less noun-like than schoology_courses/schoology_course, but the pattern remains readable and stable.
Three tools is on the thin side for a course-management domain, though each earns its place in a read-only browsing workflow. It sits at the borderline where a couple more capabilities (e.g. assignment detail, grades) would make the surface feel complete.
The surface covers browsing courses and upcoming work, but stops there: no grades, submissions, announcements/messages, or drill-down into a single assignment are exposed. These are core student workflows, so an agent asked about grade status or assignment details will hit a dead end.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Read your events, sales, orders and attendees from your AI assistant. OAuth sign-in, read only.
Secure AI access to OpenOak tasks, notes, and Kanban boards.
Connect AI assistants to JustRoadmap to list, read and update workspaces, roadmaps, lanes and items. OAuth sign-in with read-only or read-and-change access per workspace. No delete tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access Canvas LMS course content, including assignments, modules, announcements, and files, to help students manage their coursework.11 npmISC
- AlicenseAqualityBmaintenanceEnables AI apps to read a student's courses, due dates, grades, missing work, announcements, modules, discussions, syllabus, and calendar events in a read-only way. It cannot submit, edit, or delete anything, and credentials go only to the user's own school.21180 npmMIT
- 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 gradedqualityBmaintenanceEnables AI assistants to inspect enrolled courses, extract readable text from course documents, track upcoming deadlines, view announcements, and retrieve assignment details through the platform’s REST API.MIT