ManageBac MCP Server
ManageBac MCP Server
Ein lokaler MCP-Server, der es KI-Agenten (Claude Code, Claude Desktop, OpenCode, ChatGPT usw.) ermöglicht, dein ManageBac-Konto zu lesen und damit zu interagieren: Abgabefristen, Noten, Ankündigungen, Ressourcen und das Einreichen von Aufgaben.
Er meldet sich über ein echtes Browserfenster an (du meldest dich einmal an), speichert die Sitzung lokal und verwendet sie erneut — dein Passwort wird niemals gespeichert oder irgendwohin gesendet.
Tools
managebac_get_classes— listet deine Klassen aufmanagebac_get_all_deadlines/managebac_get_class_deadlines— anstehende, vergangene und überfällige Aufgabenmanagebac_get_grades/managebac_get_class_grades/managebac_get_recent_class_grades— Noteneinträgemanagebac_get_gpa/managebac_get_class_gpa— GPA, wie auf der Seite angezeigt (niemals geschätzt)managebac_get_class_grade_weights— Kategoriegewichtung für eine Klassemanagebac_get_announcements— Ankündigungen/Hinweise von der Schul- und Klassenseitemanagebac_get_class_resources— herunterladbare Dateien/Ressourcen (Kursarbeiten, Materialien) für eine Klassemanagebac_download_file— lädt eine Datei (einen Anhang oder Ressourcen-Href) als base64 heruntermanagebac_get_assignment_details— Bewertungsraster, Anweisungen und Anhänge für eine Aufgabemanagebac_submit_assignment— hängt eine Datei (von der Festplatte oder als base64 für Clients wie ChatGPT ohne lokalen Dateizugriff) oder Text an eine Aufgabe an; führt immer zuerst einen Dry Run ausmanagebac_get_cas_info/managebac_get_ee_info— CAS/Extended Essay Reflexionen, sobald freigeschaltetmanagebac_check_session/managebac_runtime_info— Sitzungsstatus und Prozessdiagnosemanagebac_list_links/managebac_debug_snapshot— Debugging-Hilfen zum Auffinden von Seitenpfaden
Ankündigungen und Ressourcen werden nach bestem Bemühen bereitgestellt: Die Seitenstruktur von ManageBac variiert je nach Schule. Wenn die Ergebnisse also dürftig aussehen, bitte den Agenten, mithilfe von managebac_list_links oder managebac_debug_snapshot die richtige Seite zu finden, und übergib sie als path.
Related MCP server: agentify-desktop
Installation
Erfordert Node.js 20+.
git clone https://github.com/DH4410/managebac-mcp-server.git
cd managebac-mcp-server
npm install
npm run build
npm run install-browser # first time only, installs Chromium for PlaywrightKopiere die Env-Datei und setze die ManageBac-URL deiner Schule:
cp .env.example .envMANAGEBAC_BASE_URL=https://your-school.managebac.comMelde dich einmal an (öffnet ein echtes Browserfenster, speichert die Sitzung und schließt dann):
npm run loginMit deinem KI-Agenten verbinden
Die meisten MCP-Clients (Claude Code, Claude Desktop, OpenCode, Cursor) führen MCP-Server als lokalen Prozess aus. Füge etwa Folgendes zu ihrer MCP-Konfiguration hinzu:
{
"mcpServers": {
"managebac": {
"command": "node",
"args": ["/absolute/path/to/managebac-mcp-server/dist/index.js"],
"env": {
"MANAGEBAC_BASE_URL": "https://your-school.managebac.com",
"MANAGEBAC_STORAGE_STATE": "/absolute/path/to/managebac-mcp-server/.managebac/storage-state.json"
}
}
}
}Speziell für Claude Code: Füge dies in .mcp.json im Repository-Stammverzeichnis ein, führe dann /mcp aus und genehmige den Server.
Mit ChatGPT verbinden
ChatGPT verbindet sich nur über eine URL mit MCP-Servern (nicht über einen lokalen Prozess). Dein lokaler Server benötigt daher eine temporäre öffentliche URL und ein geheimes Token, um ihn zu schützen. Dein ManageBac-Login verlässt deinen Rechner weiterhin nie — nur die Tool-Antworten überqueren den Tunnel, und das auch nur, solange du ihn nutzt.
Schnellster Weg — ein Befehl:
npm install cloudflared # one-time; downloads the cloudflared binary (~40MB)
npm run chatgptDas baut den Server, startet ihn im HTTP-Modus, öffnet einen Cloudflare-Quick-Tunnel und gibt einen Block wie diesen aus:
=================================================
ChatGPT connector settings
=================================================
URL: https://random-words.trycloudflare.com/mcp
Auth: Bearer token
Token: 9f2a1c...
=================================================In ChatGPT: Einstellungen → Connectors → Erweiterter Modus/Entwicklermodus → Connector hinzufügen, füge dann die URL ein und stelle die Authentifizierung auf Bearer-Token mit dem angezeigten Token.
Lass das Terminal geöffnet, solange ChatGPT Zugriff haben soll — das Schließen (oder Ctrl+C) beendet sowohl den Tunnel als auch den Server. URL und Token sind bei jedem Ausführen des Befehls neu. Daher füge sie nach einem Neustart erneut in ChatGPT ein.
Manueller Weg (falls du das Paket cloudflared nicht hinzufügen möchtest): Setze MCP_TRANSPORT=http, MCP_HTTP_PORT=3939 und MCP_HTTP_TOKEN=<a long random value> in .env, führe npm start aus, richte dann ein beliebiges HTTPS-Tunnelwerkzeug (z. B. cloudflared tunnel --url http://localhost:3939, falls du cloudflared bereits separat installiert hast) auf Port 3939 aus und verwende <tunnel-url>/mcp + dein Token in ChatGPT auf dieselbe Weise.
Hinweise
.envund.managebac/(deine gespeicherte Sitzung) sind git-ignoriert — committe sie niemals.Wenn du den Code änderst oder dich neu anmeldest, starte deinen MCP-Client neu, damit er den neuen Prozess übernimmt.
Wenn ManageBac dein Konto sperrt, versuche nicht weiterhin, dich automatisch anzumelden, sondern verwende stattdessen
npm run login(manuell).
Fehlerbehebung
Wenn Abgabefristen oder GPA nicht stimmen, verwende die Debug-Tools, um zu sehen, was der Scraper findet:
managebac_list_links({ "match": "task" })
managebac_debug_snapshot({ "path": "/student/tasks_and_deadlines?view=upcoming" })Optional: automatische Passwort-Anmeldung
Standardmäßig deaktiviert (manuelle Anmeldung ist sicherer). Zum Aktivieren setze in .env:
MANAGEBAC_LOGIN_MODE=password
MANAGEBAC_EMAIL=your.email@example.com
MANAGEBAC_PASSWORD=your-passwordTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory, knowledge graph, task management and more for AI agents via MCP.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Browz hosted MCP (free public beta): let an AI app drive your own Browz browser profiles from anywhere. Connect https://mcp.gobrowz.com/mcp and sign in with your Browz account (OAuth) or an agent token. Each call is relayed to the Browz app on your computer, which must be online with Remote control on and have a hardware security chip (Mac Secure Enclave or TPM 2.0). 17 tools: profiles, tabs, navigate, snapshot, act, wait, screenshot. Cookies, downloads and stored sign-ins stay on your computer.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation, and network monitoring directly within your daily Chrome environment.MIT

agentify-desktopofficial
AlicenseNot gradedqualityDmaintenanceMCP server that enables AI tools to control local browser sessions for ChatGPT, Claude, and other AI services, supporting querying, navigation, file uploads, and artifact management.575Mozilla Public 2.0- AlicenseAqualityDmaintenance使AI代理能够通过学生账号读取ManageBac中的截止日期、成绩条目和GPA的MCP服务器。121ISC
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to read Google Classroom data—including coursework, submissions, announcements, and Drive attachments—through a remote, OAuth-protected MCP server with interactive Google sign-in.-