iitkgp-erp-mcp

MCP server for IIT Kharagpur ERP. Query your grades, CGPA, attendance, timetable, placements, and more through any AI agent.

Works with: Claude Code, Claude Desktop, Cursor, Cline, Continue, Zed, custom agents — anything that speaks MCP.

Install

pip install iitkgp-erp-mcp
playwright install chromium

Related MCP server: Canvas MCP

Setup

iitkgp-erp-setup

This stores your credentials securely in your OS keychain.

Usage

Add to your MCP client config (.mcp.json, mcp_servers.json, etc.):

{
  "mcpServers": {
    "iitkgp-erp": {
      "command": "iitkgp-erp-mcp"
    }
  }
}

Then ask your AI agent:

• "What's my CGPA?"

• "Show my grades for semester 4"

• "Compare my performance in CS vs MA subjects"

• "If I get A in all subjects this sem, what's my CGPA?"

• "Which breadth electives should I take?"

• "Any new placement notices for SDE roles?"

• "Can I skip tomorrow's Signals class?"

• "What's my schedule today?"

• "Export my timetable to Google Calendar"

• "Browse the fee payment page"

Available Tools (25)

Grades & GPA

Attendance

Elective Recommender

Timetable & Schedule

Placements & Notices

Explorer

Utility

Security

• Credentials stored in OS keychain (never plaintext)

• Session is local to your machine

• OTP entered live, never stored

• Nothing sensitive is committed to git

How it works

Your AI Agent ←→ MCP Protocol (stdio) ←→ iitkgp-erp-mcp server
                                              │
                                              ├── iitkgp-erp-login (auth)
                                              ├── requests + BeautifulSoup (scraping)
                                              └── Playwright (JS-heavy pages)
                                              │
                                              ▼
                                        erp.iitkgp.ac.in

Grading Scale

Roadmap

• Grades & GPA tools

• Attendance tracking + alerts

• Elective recommender

• Placement notice integration

• Timetable extraction

• Calendar sync (ICS export)

• Prof finder

• Academic notices

• Freeform ERP browser

• Batch grade distributions (historical data)

• Registration status

• Fee payment status

• Hostel info

Contributing

PRs welcome! The scrapers in src/scrapers/ may need selector updates if ERP changes its HTML structure.

License

MIT