induslms-academics
This server gives read-only access to Indus LMS academics (courses, resources, assignments, notifications, attendance, announcements, calendar) plus school email via Outlook/Graph or Apple Mail — 22 MCP tools documented, 19 shown in the schema (the od_* OneDrive/SharePoint file tools are absent here).
Profile & courses:
get_profile(email, name, id);list_courses(courses, teachers, class IDs, optional year filter).Shared resources:
list_resources(browse folders/files by course, parent id, paging);get_resource(metadata, child_count, file_urls);download_resource(save a file to~/Downloads/induslms).Assignments:
assignments_overview(EOL tests + assessments + resources combined);list_eol(end-of-lesson tests with status/score/due);list_assessments(FA/SDL with due dates and teachers).Notices & schedule:
list_notifications(unread counts, deep links,unread_only);list_announcements(filter by tenant/academic year);list_calendar(school events).Attendance:
get_attendance(summary percentage, present/absent);get_attendance_day(per-date status and reason).Outlook/Graph email (any OS):
outlook_search(query/sender/since),outlook_read(message by id, truncated body),outlook_folders(unread/total counts).Apple Mail email (macOS, zero setup):
schoolmail_search,schoolmail_read(byMailbox:idref),schoolmail_folders.Strictly non-mutating: no submit, send, mark-read, or any write/mutation tools.
Provides read-only access to the School mailbox in Apple Mail.app on macOS via osascript (JXA), enabling agents to list mail folders, search messages, and read individual emails by mailbox and id.
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., "@induslms-academics list my courses and upcoming 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.
IndusLMS Agent
Agent access to Indus LMS academics — announcements, assignments, results, learning tasks, shared resources, messages, notifications, attendance, policies — plus school email and OneDrive files. For pi, opencode, Claude Code/Desktop, and OpenAI-compatible agents via MCP + Skill + CLI.
Since 0.4.0 the client can also act for you: hand in files, send messages, mark notifications and announcements read, and ask for extensions. These calls are markedWRITE, never retry on their own, and the CLI asks before sending. Taking tests stays with the student: the interactive induslms eol-take exists, but no MCP tool answers or submits a test. School email and OneDrive remain read-only.
Quickstart
git clone https://github.com/StrangeSid/induslms-agent.git
cd induslms-agent
./install.shinstall.sh creates .venv, installs the package, logs you in, wires up MCP configs for pi + opencode, installs the skill, and runs a health check. Then restart your agent host and ask: "list my courses using induslms-academics".
python3 -m venv .venv && source .venv/bin/activate
pip install -e . # or: pip install -r requirements.txt
cp .env.example .env # fill in your values (auto-loaded, never committed)
python3 lms.py login you@school.example
python3 lms.py doctor # health checkOr from PyPI: pipx install induslms-agent (or uvx induslms-agent doctor), then induslms login you@school.example and use induslms-server as your MCP command.
Updating
pipx upgrade induslms-agent # PyPI install
git pull && ./install.sh # git clone (re-runs doctor to verify)No re-login needed: tokens live outside the repo and survive updates. If a release adds new Graph scopes, run python3 sharepoint.py login (or outlook.py login) once to consent.
Related MCP server: OpsPilot MCP Server
Configuration
Variable | Purpose |
| Used once by |
| Tenant fallback when the token has no roles |
| Token cache path (default |
| Optional custom Entra app id (default: builtin Office → Thunderbird, no registration) |
| Force custom app id only (disables builtin Office/Thunderbird chain) |
Credentials live only in your local process environment. The MCP server exposes no login/token tools, no tool ever returns secrets, and .gitignore blocks .env, *token*.json, and downloads. The access token is refreshed shortly before it expires and the new pair is saved back (0600), so a lapsed token no longer breaks the CLI or MCP server. Upload tools refuse hidden paths and the token file.
MCP server
Stdio, 42 tools. Run with python3 server.py (or induslms-server after install).
Group | Tools |
LMS academics |
|
LMS details |
|
LMS writes |
|
Mail (macOS, no setup) |
|
Mail (Graph, any OS) |
|
Files (Graph, any OS) |
|
Connect your host (replace /path/to with your checkout; ready-made files in examples/):
Host | Config |
pi |
|
opencode |
|
Claude Code |
|
Claude Desktop | paste |
OpenAI SDK |
|
School email
Apple Mail.app (macOS, zero setup):
python3 mailapp.py search "assignment" --top 5— reads the existingSchoolaccount via osascript. On other platforms these tools report unavailable; use Outlook instead.Outlook/Graph (any OS, no registration, no code typing):
.venv/bin/python outlook.py login(browser opens, sign in once), thensearch/read/folders. Uses builtin Office → Thunderbird clients as yourself (Mail.Readuser consent, no admin, no Azure app). Headless fallback:login --device.
OneDrive / SharePoint files (any OS, no registration)
Same browser sign-in + token cache as Outlook (Files.Read + Sites.Read.All user consent, one login covers mail + files):
.venv/bin/python sharepoint.py login
.venv/bin/python sharepoint.py resolve <sharing-link-from-mail>
.venv/bin/python sharepoint.py browse /
.venv/bin/python sharepoint.py download <item-id-or-link> --out /tmp/schoolSkill + prompt template
Skill (
skills/induslms-academics/): workflow guidance for agents (notices → assignments → resources → attendance + inbox). Install:bash scripts/install-skill.sh(pi, opencode, Claude).Prompt (
examples/update-resources.prompt.md): copy-paste template that refreshes a localSchool/folder from LMS + mailbox. Fill in your subjects/teachers, paste into a fresh agent session.API reference:
skills/induslms-academics/references/endpoints.md(reverse-engineered endpoints, verified live).
Contributing, changelog, license
See CONTRIBUTING.md and CHANGELOG.md. Licensed under GPL-3.0-or-later — see COPYING.
Available Tools
22 toolsassignments_overviewC
Unified assignments: EOL tests + assessments + shared resources (raw payloads).
Inputs: course_id. Returns: object
download_resourceC
Download a shared file to ~/Downloads/induslms. Returns path, size, content-type.
Inputs: file_id (required), resource_id (required). Returns: object
get_attendanceB
Attendance summary + session records (percentage, present/absent).
Inputs: no named parameters. Returns: object
get_attendance_dayB
Day-wise attendance breakdown (working days, per-date status/reason).
Inputs: no named parameters. Returns: object
get_profileB
Current student profile (email, full name, id).
Inputs: no named parameters. Returns: object
get_resourceC
One resource's metadata: folder flag, child_count, file_urls with file_ids.
Inputs: resource_id (required). Returns: object
list_announcementsC
School announcements, optionally filtered by tenant/year.
Inputs: tenant, academic_year. Returns: object
list_assessmentsC
FA/SDL assessments with due dates and teacher names.
Inputs: no named parameters. Returns: object
list_calendarC
School calendar events.
Inputs: no named parameters. Returns: object
list_coursesD
Student courses with teachers and class IDs (DP program).
Inputs: year. Returns: object
list_eolC
Teacher-published end-of-lesson tests with status, score, due messages.
Inputs: limit, offset. Returns: object
list_notificationsB
Notifications with unread_count and deep links (read-only; no mark-read).
Inputs: limit, offset, unread_only. Returns: object
list_resourcesC
Shared teacher resources (folders + files). Use parent_resource_id to open a folder.
Inputs: page, course_id, page_size, parent_resource_id. Returns: object
od_browseB
List a OneDrive folder by path (or a SharePoint default-drive folder with site_id).
Inputs: path, site_id. Returns: object
od_downloadA
Download a OneDrive/SharePoint file by item id or sharing link to ~/Downloads/induslms.
Inputs: target (required). Returns: object
od_resolve_linkB
Resolve a OneDrive/SharePoint sharing link (from mail) to file metadata + folder children.
Inputs: link (required). Returns: object
outlook_foldersC
Outlook mail folders with unread/total counts.
Inputs: no named parameters. Returns: object
outlook_readB
Read one Outlook message (subject, from, date, truncated body).
Inputs: message_id (required), max_body. Returns: object
outlook_searchC
Search school Outlook inbox (teacher emails, assignment notices). since = ISO date.
Inputs: top, query, since, sender. Returns: object
schoolmail_foldersC
School account mailboxes with message counts.
Inputs: no named parameters. Returns: object
schoolmail_readB
Read one School email by ref 'Mailbox:id' (subject, from, date, body).
Inputs: ref (required), max_body. Returns: object
schoolmail_searchC
Search School inbox in Apple Mail.app (no setup; newest first). since = ISO date.
Inputs: top, query, since, sender, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Several tool pairs overlap in purpose: get_attendance vs get_attendance_day, outlook_* vs schoolmail_* (same operations on two mail sources), and od_download vs download_resource. Descriptions do clarify the distinctions, but an agent must read carefully to pick the right one for a given source/scope.
Mostly snake_case verb_noun (list_resources, get_attendance, download_resource), but mail/OneDrive tools use source prefixes where the verb comes after (od_browse, outlook_search, schoolmail_folders), which is a minor deviation from the dominant pattern. Still readable and predictable overall.
22 tools is on the heavy side. The breadth of domains (attendance, assessments, resources, calendar, notifications, courses, profile) justifies many, but the dual mail stacks (outlook_* and schoolmail_*) and dual download tools create near-duplicate surface that inflates the count.
Covers the main student read workflows: profile, courses, attendance (summary+day), assessments, EOL, resources, calendar, announcements, notifications, and mail. Gaps are minor (no mark-read for notifications by design, no assignment submission), leaving the surface largely workable.
Maintenance
Related MCP Connectors
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Read-only Frasma MCP: profile, knowledge search, diagnostic handoff. No email.
Related MCP Servers
- AlicenseAqualityBmaintenanceGives MCP-capable agents read-only access to a Google Classroom account, exposing courses, coursework, due dates, announcements, rosters and student submissions as callable tools. Nothing can be created, edited or deleted through it.8MIT
- AlicenseNot gradedqualityBmaintenanceProvides read-only, deterministic tools for searching accounts and knowledge and retrieving tickets, ticket details, and product information over a stdio MCP connection.MIT
- AlicenseAqualityCmaintenanceEnables a tutor or assistant to read a student's Brightspace courses, deadlines, announcements, assignment instructions, course outlines, quiz metadata and released grades, plus search explicitly imported school notes and read course documents. Runs locally over stdio with read-only access and configurable tenant settings.181MIT
- AlicenseNot gradedqualityBmaintenanceExposes 22 typed, read-only MCP tools that let an agent answer questions about a student's own Ed discussion threads, Moodle deadlines and course materials, Gmail inbox, and OnTrack task feedback. Runs locally over stdio with credentials captured once by a CLI login, so the agent never handles passwords and never writes to any service.88 npm1MIT