Skip to main content
Glama

IndusLMS Agent

PyPI Python License

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.

NOTE

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

Or 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

INDUSLMS_EMAIL / INDUSLMS_PASS

Used once by lms.py login, then discarded

INDUSLMS_TENANT

Tenant fallback when the token has no roles

INDUSLMS_TOKEN_FILE

Token cache path (default ~/.induslms_token.json)

INDUS_OUTLOOK_CLIENT_ID

Optional custom Entra app id (default: builtin Office → Thunderbird, no registration)

INDUS_USE_BUILTIN_CLIENT=0

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

get_profile, list_courses, list_resources, get_resource, download_resource, assignments_overview, list_eol, list_assessments, list_notifications, get_attendance, get_attendance_day, list_announcements, list_calendar

LMS details

get_eol_result, get_assessment_submission, get_assessment_feedback, get_request_status, list_learning_tasks, get_learning_task, list_announcements_full, list_message_contacts, list_message_threads, get_conversation, list_policies

LMS writes

send_message, mark_notification_read, mark_all_notifications_read, mark_announcement_read, request_extension_or_resubmission, cancel_request, submit_assessment_files, submit_learning_task

Mail (macOS, no setup)

schoolmail_search, schoolmail_read, schoolmail_folders

Mail (Graph, any OS)

outlook_search, outlook_read, outlook_folders

Files (Graph, any OS)

od_resolve_link, od_browse, od_list_sites, od_download

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

Host

Config

pi

~/.pi/agent/mcp.json (or run ./install.sh, which merges it)

opencode

~/.config/opencode/opencode.jsonc under mcp (v1) or mcp.servers (v2)

Claude Code

claude mcp add induslms-academics -- <venv-python> <checkout>/server.py, or copy .mcp.json

Claude Desktop

paste examples/claude_desktop_config.json.example into claude_desktop_config.json, relaunch

OpenAI SDK

MCPServerStdio with {command: <venv-python>, args: [server.py]}; hosted MCP/GPT Actions need public HTTPS (not provided, stdio-only by design)

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, no registration, no code typing): .venv/bin/python outlook.py login (browser opens, sign in once), then search / read / folders. Uses builtin Office → Thunderbird clients as yourself (Mail.Read user 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/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.

Available Tools

22 tools
assignments_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

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 22 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides read-only, deterministic tools for searching accounts and knowledge and retrieving tickets, ticket details, and product information over a stdio MCP connection.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      18
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes 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 npm
      1
      MIT