edupage-mcp 0.1.1

Read-only EduPage MCP server for timetables, grades, notifications, meals, and school metadata

edupage-mcp

edupage-mcp is a read-only MCP server for EduPage. It lets MCP clients and agents query timetable data, grades, notifications, meals, and school metadata through the edupage-api library.

Supported Features

Supported tools:

• get_timetable
• get_grades
• get_notifications
• get_teachers
• get_students
• get_classes
• get_subjects
• get_meals
• get_substitutions
• get_timetable_changes

Experimental tool:

• get_missing_teachers

get_missing_teachers is exposed, but some schools block teacher substitution visibility entirely, so it may return an availability message instead of teacher data.

Requirements

• Python 3.10+
• uv
• An EduPage account
• EduPage 2FA disabled
• Your school subdomain from https://<subdomain>.edupage.org

Environment variables:

EDUPAGE_USERNAME=your_username
EDUPAGE_PASSWORD=your_password
EDUPAGE_SUBDOMAIN=your_school_subdomain

Run It

Install and run from PyPI with uvx:

uvx edupage-mcp

For local development:

uv sync
uv run edupage-mcp

The server uses stdio transport, so it is meant to be launched by an MCP client.

MCP Setup

OpenCode

Add this to ~/.config/opencode/opencode.json or project opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "edupage": {
      "type": "local",
      "command": ["uvx", "edupage-mcp"],
      "environment": {
        "EDUPAGE_USERNAME": "your_username",
        "EDUPAGE_PASSWORD": "your_password",
        "EDUPAGE_SUBDOMAIN": "your_school_subdomain"
      }
    }
  }
}

Claude Desktop

Add this to your Claude Desktop MCP config:

{
  "mcpServers": {
    "edupage": {
      "command": "uvx",
      "args": ["edupage-mcp"],
      "env": {
        "EDUPAGE_USERNAME": "your_username",
        "EDUPAGE_PASSWORD": "your_password",
        "EDUPAGE_SUBDOMAIN": "your_school_subdomain"
      }
    }
  }
}

Tool Summary

Tool	Parameters	Description
get_timetable	date_str	Timetable for a date. Defaults to today.
get_grades	year, term	Grades, optionally filtered by school year and term.
get_notifications	date_from	Notifications, optionally from a given date onward.
get_teachers	none	Teachers at the school.
get_students	none	Students in the logged-in student's class.
get_classes	none	School classes.
get_subjects	none	School subjects.
get_meals	date_str	Meal menu for a date. Defaults to today.
get_substitutions	date_str	Raw substitution rows for a date. Defaults to today.
get_timetable_changes	date_str	Timetable changes for a date. Defaults to today.
get_missing_teachers	date_str	Absent teachers for a date. Experimental.

Limitations

• Read-only only
• No 2FA support
• Parent and teacher accounts are not verified
• Depends on upstream edupage-api behavior

Acknowledgements

This project would not be possible without the upstream edupage-api library:

https://github.com/EdupageAPI/edupage-api