Skip to content

kao-offline/ssps-schoolwork

v0.1.0

Read homework, project instructions, deadlines, announcements and documents from the student's Teams and Bakalari accounts.

SSPS MCP — schoolwork, already in context

Give your agent the context for schoolwork: Bakaláři, Teams and Discord, using your own accounts.

Install page · Setup & recovery · Teams feature map

One command

Install Git, Node.js 22.13+ (with npm) and Google Chrome, then open a terminal.

Windows · PowerShell

irm https://sspsmcp.kaooffline.top/install.ps1 | iex

macOS / Linux · Bash

curl -fsSL https://sspsmcp.kaooffline.top/install.sh | bash

You can inspect the Windows script or Bash script before running it.

  1. Sign in to your own accounts. Teams uses Chrome; the default flow needs no Microsoft app registration.
  2. Watch the first cache load. Setup shows progress before it finishes; the rest loads in the background.
  3. Open a new session in your agent and ask: “What homework is due this week?”

The installer stays in one full-screen interface through choices, sign-in and installation, then waits on its Done screen. Enable the optional 2B module to add Tasks View as a live task source. Search observed class Discord names for role-based group suggestions, or choose groups and subjects manually. Names and selections stay in your local protected profile.

Setup detects supported installed apps, adds MCP configuration and installs skills where supported. Includes Hermes, Codex, Claude, Grok, Gemini, Cursor and more. Unknown apps get manual import instructions; hosted agents need a separate connection.

The 2B picker offers all known groups without requiring Discord or timetable discovery:

ChoiceOptions
MathSoučková, Frei, Miškovský, Zýková
EnglishČernovická (Aj Čer.), Hanuš, Kratochvíle, Novák, Aj Přech, Aj Čamrda | Doneva
ProgrammingPR11 Inneman, PR21 Hejduk, PR22 Šrámek, PR31 Procházka
Shared class halfSK1 or SK2 for HAR, WBA, PCV, GRS, TEV, PDV and PSI
LanguageNěmčina or Španělština

Other teacher groups discovered from your sources and manual entry remain available. Zýková, Přech and Čamrda/Doneva use observed role labels; their full identities are unconfirmed. OSE is omitted for now.

What it reads

  • Bakaláři: homework, messages, marks, timetable and available lesson context.
  • Teams: assignments, deadlines, announcements and accessible document context.
  • Discord: accessible servers and DMs exposed by your session. History is partial until visited and cached.

Cached context responds quickly. Background readers check for changes; freshness is reported. The integration is read-only.

Your data

Accounts, browser sessions and caches stay on your computer. The install website hosts only public files. On Windows, saved token/cache files use your Windows account’s encryption; other systems use private file permissions. Chrome keeps its own local profile.

This does store a local cache. Your agent’s AI provider may receive the context you ask it to use. Do not share your private data folder or send passwords in agent chats.

Already cloned?

node scripts/setup.mjs

Use --detect to list apps, --apps=hermes,codex,claude,grok to select them, or --sources=teams,bakalari to skip Discord. Full options and supported clients →

For development: npm ci, then npm run check. Website deployment →