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.

Quickstart

git clone https://github.com/StrangeSid/induslms-agent.git
cd induslms-agent
./install.sh

install.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 check

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.

Configuration

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, 41 tools. Run with python3 server.py (or induslms-server after install).

Connect your host (replace /path/to with your checkout; ready-made files in examples/):

School email

• Apple Mail.app (macOS, zero setup): python3 mailapp.py search "assignment" --top 5 — reads the existing School account via osascript. On other platforms these tools report unavailable; use Outlook instead.
• Outlook/Graph (any OS): python3 outlook.py login (approve the code in your browser), then search / read / folders. Needs Mail.Read: your own app id + one admin consent, or INDUS_USE_BUILTIN_CLIENT=1 for no-registration sign-in.

OneDrive / SharePoint files (any OS)

Same device-code flow and token cache as Outlook, plus Files.Read + Sites.Read.All (re-run login once to consent):

python3 sharepoint.py login
python3 sharepoint.py resolve <sharing-link-from-mail>
python3 sharepoint.py browse /
python3 sharepoint.py download <item-id-or-link> --out /tmp/school

Skill + 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 local School/ 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.