Content
<div align="center">
# 🎓 Schoology
**Your grades, assignments, and messages — in Claude.**
[](https://github.com/riripatate/schoology-api/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@schoologymcp/mcp)
[](https://opensource.org/licenses/MIT)
Log in once with your username and password. Ask Claude anything about your classes.
</div>
---
## Install
Pick your Claude. Copy the prompt. Paste it. Done.
<br />
### <img src="https://claude.ai/favicon.ico" width="18" /> Claude Code
Open Claude Code and paste:
> Run `claude mcp add schoology -- npx -y @schoologymcp/mcp`. The first time it starts, a browser tab opens where I'll sign in to Schoology. Confirm it's working by listing my classes.
<br />
### <img src="https://claude.ai/favicon.ico" width="18" /> Cowork
Open Cowork and paste:
> Add `npx -y @schoologymcp/mcp` to my Cowork MCP config. On first run it opens a browser tab for Schoology sign-in — no credentials needed in the config. Verify it works by fetching my grades.
<br />
---
## What you can ask
- *What are my grades this semester?*
- *What's due this week?*
- *Summarize my unread messages.*
- *When's my next math test?*
- *Which classes am I doing worst in?*
## What it can do
| | |
|---|---|
| 📊 Grades | Full report across all classes |
| 📝 Assignments | Due dates, descriptions, status |
| 💬 Messages | Inbox, sent, read threads |
| 📅 Calendar | Upcoming events and deadlines |
| 🏫 Classes | Sections, courses, discussions |
| 👥 Groups | Memberships and group content |
## Requirements
- Claude Code or Cowork
- Your Schoology username and password
- Node.js 18+
That's it. No API keys. No admin access.
## How it works
Most schools lock down Schoology's official API. This skill logs in as you — in an invisible browser — captures the session, and queries Schoology directly. Your password is never stored. Sessions are encrypted and expire in 12 hours.
Works with native logins, Google SSO, Microsoft SSO, Clever, and SAML.
## License
MIT