MyDy LMS Helper

A terminal UI application and MCP server for interacting with the MyDy (Moodle-based) LMS at D.Y. Patil institutions. View attendance, browse courses, check assignments and grades, read announcements, and download course materials.

Screenshots

Related MCP server: schoology-mcp

Features

• Dashboard — Attendance summary + current semester courses at a glance

• Course Detail — Tabbed view with Content, Assignments, Grades, and Announcements

• Download Materials — Download from a single course or bulk download from multiple

• Login Screen — Auto-login from .env or manual login via the UI

• MCP Server — Let AI assistants interact with your LMS

Setup

1. Clone and install

git clone https://github.com/your-username/mydy-lms-helper.git
cd mydy-lms-helper
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate   # Windows
uv pip install -r requirements.txt
# or: pip install -r requirements.txt

2. Configure credentials (optional)

Create a .env file:

MYDY_USERNAME="your_email@dypatil.edu"
MYDY_PASSWORD="your_password"

If no .env is present, the app will show a login screen on startup.

3. Run the TUI

python __main__.py

Navigation

MCP Server

The project also includes an MCP (Model Context Protocol) server for AI assistants like Claude Code.

Quick Setup with Claude Code

claude mcp add mydy-lms -e MYDY_USERNAME=your_email@dypatil.edu -e MYDY_PASSWORD=your_password -- python /path/to/mcp_server.py

Manual Config

{
  "mcpServers": {
    "mydy-lms": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "MYDY_USERNAME": "your_email@dypatil.edu",
        "MYDY_PASSWORD": "your_password"
      }
    }
  }
}

Available MCP Tools

Project Structure

mydy-lms-helper/
├── __main__.py       # Entry point
├── app.py            # Textual TUI application
├── client.py         # HTTP client (shared by TUI and MCP server)
├── mcp_server.py     # MCP server for AI assistants
├── requirements.txt  # Dependencies
└── .env              # Credentials (gitignored)

Requirements

• Python 3.10+

• Internet connection

• Valid MyDy LMS account

License

MIT License. Use at your own risk.

Disclaimer

This tool is for educational purposes only. Respect your institution's terms of service and use responsibly. Only download content you have legitimate access to. This project is unofficial and made for personal/educational use. DY Patil or MyDY is not associated with this project.

Use responsibly. The author is not responsible for misuse, data loss, or violations of institutional policies.