Edupage MCP Server

MCP server that connects Claude to Edupage — a school information system used across Europe. Provides access to timetables, grades, homework, messages, students, teachers, and more.

Quick Setup

1. Install

cd /path/to/edupage-mcp
uv sync

Or if you prefer a one-liner without cloning:

uv pip install "mcp>=1.2.0" "edupage-api>=0.12.3"

2. Configure for Claude Code

The easiest way — just open the project folder and the .mcp.json will be picked up automatically. Set environment variables first:

export EDUPAGE_USERNAME=your_user
export EDUPAGE_PASSWORD=your_pass
export EDUPAGE_SUBDOMAIN=your_school

Or add the server manually:

claude mcp add edupage -- uv run --directory /path/to/edupage-mcp python -m edupage_mcp

With auto-login via environment variables:

claude mcp add --env EDUPAGE_USERNAME=your_user --env EDUPAGE_PASSWORD=your_pass --env EDUPAGE_SUBDOMAIN=your_school edupage -- uv run --directory /path/to/edupage-mcp python -m edupage_mcp

3. Configure for Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "edupage": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/edupage-mcp", "python", "-m", "edupage_mcp"],
      "env": {
        "EDUPAGE_USERNAME": "your_username",
        "EDUPAGE_PASSWORD": "your_password",
        "EDUPAGE_SUBDOMAIN": "your_school"
      }
    }
  }
}

4. Configure for Cowork

Use the .mcp.json file included in this repo — just set the environment variables.

Authentication

Two options:

1. Environment variables (recommended) — set EDUPAGE_USERNAME, EDUPAGE_PASSWORD, and EDUPAGE_SUBDOMAIN. The server logs in automatically at startup.
2. Manual login tool — call the login or login_auto tool at the start of your session.

The subdomain is the part before .edupage.org in your school's URL (e.g. myschool for https://myschool.edupage.org).

Available Tools

Tool	Description
login	Log in with username, password, subdomain
login_auto	Log in via portal (auto-detect school)
get_timetable	Get timetable for a date
get_next_week_timetable	Get Mon-Fri timetable for next week
get_timetable_changes	Get substitutions / changes for a date
get_grades	Get student grades/marks
get_students	Get students in your class
get_all_students	Get all students in the school
get_teachers	Get all teachers
get_classes	Get all classes
get_classrooms	Get all classrooms
get_homework	Get homework assignments
get_assignments	Get all assignments (homework, tests, etc.)
get_timeline	Get recent timeline items
get_notifications	Get recent notifications
get_notification_history	Get notifications since a date
get_news	Get school news
get_meals	Get meal information
send_message	Send a message to users
get_subjects	Get all subjects
get_periods	Get bell schedule / periods
get_my_children	Get children linked to a parent account
get_absences	Get student absences
get_upcoming_events	Get upcoming school events
get_student_summary	All-in-one summary: grades, homework, exams, absences

Project Structure

edupage-mcp/
├── CLAUDE.md              # Developer guide
├── pyproject.toml         # Package config (uv/hatch)
├── .mcp.json              # Claude Code project config
├── .env.example           # Example environment variables
└── src/
    └── edupage_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # MCP server implementation

Development

Run the server directly for testing:

uv run python -m edupage_mcp

Test with MCP Inspector:

npx @modelcontextprotocol/inspector uv run python -m edupage_mcp

Dependencies

• mcp >= 1.2.0 — Model Context Protocol Python SDK
• edupage-api >= 0.12.3 — Unofficial Edupage API client (GitHub)

Notes

• The server uses stdio transport (reads stdin, writes stdout)
• All logging goes to stderr to avoid corrupting the MCP protocol
• Session persists for the lifetime of the server process
• The send_message tool sends real messages — use with care
• If Edupage requests a CAPTCHA, log in via browser first then retry

License

This project is licensed under the GPL-3.0-or-later — see the LICENSE file for details.

The edupage-api dependency is GPL-3.0 licensed, which requires derivative works to use a compatible license.