Skip to main content
Edu MCP

Edu MCP

The unified Model Context Protocol server for French school platforms.
Connect Pronote (+ ENT), ÉcoleDirecte, and Skolengo to your AI assistant in seconds.

English · Français

CI PyPI Python 3.10+ MIT License


Supported Platforms

Pronote

Pronote (+ ENT)  Stable
Toutatice, MonBureauNumérique, Île-de-France, Atrium…

Browser SSO + 2FA + QR Token
ÉcoleDirecte

ÉcoleDirecte  Beta
Student & Family multi-child spaces

Credentials + QCM 2FA
Skolengo

Skolengo  Beta
School search & federated ENT login

OAuth2 PKCE Browser

How It Works

flowchart LR
    AI["AI Assistant<br/>Antigravity · Claude · Cursor · Windsurf"] <-->|MCP stdio| Server["Edu MCP<br/>(uvx edu-mcp)"]
    Server --> P1["Pronote (+ ENT)"]
    Server --> P2["ÉcoleDirecte"]
    Server --> P3["Skolengo"]
    Server --- Store[("~/.edu_mcp/.env (0600)<br/>Session Cache &amp; Device UUID")]

Quick Start

1. Add to Your AI Client

Paste this into your MCP configuration file — no cloning or manual Python setup required:

{
  "mcpServers": {
    "edu-mcp": {
      "command": "uvx",
      "args": ["edu-mcp"]
    }
  }
}
Where is my MCP config file? (Antigravity, Claude Desktop, Cursor, Windsurf, VS Code)
Client Configuration Path
Antigravity ~/.gemini/config/mcp_config.json
Claude Desktop (macOS) ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows) %APPDATA%\Claude\claude_desktop_config.json
Cursor ~/.cursor/mcp.json or .cursor/mcp.json
Windsurf ~/.codeium/windsurf/mcp_config.json
VS Code (Copilot) .vscode/mcp.json
Alternative: Run via pip or from a local git clone
pip install edu-mcp
edu-mcp

Or from a cloned repository:

{
  "mcpServers": {
    "edu-mcp": {
      "command": "python",
      "args": ["-m", "edu_mcp"],
      "cwd": "/path/to/edu-mcp"
    }
  }
}

2. Connect in Chat

Just ask your assistant:

"Connect my Pronote / ÉcoleDirecte / Skolengo account"

  1. The assistant calls edu_setup_account and guides you through the exact flow for your platform.
  2. Pronote / Skolengo: your browser opens on the official login page; sign in normally (ENT + 2FA) and your durable token is captured automatically.
  3. ÉcoleDirecte: sign in once with QCM 2FA verification; trusted device tokens (cn/cv) are saved for future sessions.

Capabilities

Category What Your Assistant Can Do
Schedule Fetch daily/weekly timetables, room changes, cancellations, and lesson content; export .ics or .pdf.
Homework List upcoming assignments with attachments and mark homework as done/pending.
Grades & Analytics Read grades, subject & class averages, skill evaluations, report cards, simulate grades, and track progression.
School Life Check absences, delays, punishments, canteen menus, and school news.
Messaging Read unread threads and announcements (strictly read-only).
Parent Mode List linked children and switch active child seamlessly.
Full MCP Tool, Resource & Prompt Reference (25+ tools)

Unified Multi-Platform Tools (edu_*)

Tool Description
edu_list_platforms List supported platforms and search Skolengo schools.
edu_setup_account Chat-guided setup for Pronote, ÉcoleDirecte, or Skolengo.
edu_get_user_info Active user profile (name, class, school, account type).
edu_get_timetable Timetable lessons for a date range.
edu_get_homework / edu_set_homework_done Homework list and completion toggle.
edu_get_grades / edu_get_averages Individual grades and subject/class averages.
edu_get_absences Absences, delays, and punishments.
edu_get_news School announcements and news items.
edu_get_discussions / edu_get_discussion_messages Read-only messaging threads and messages.
edu_list_children / edu_select_child Multi-child switching for parent accounts.

Pronote-specific & Analytics tools (pronote_weekly_radar, pronote_simulate_grade, pronote_analyze_progression, pronote_get_evaluations, pronote_get_report, pronote_get_canteen_menu, pronote_export_ical, pronote_export_timetable_pdf, pronote_download_attachment) are also registered.

Resources & Prompts

  • Resources: pronote://student/profile, pronote://timetable/today, pronote://homework/pending, pronote://grades/overview, pronote://messages/unread, pronote://academics/weekly-radar
  • Prompts: pronote_daily_briefing, pronote_homework_planner, pronote_period_review
Environment Variables (resolved from PRONOTE_ENV_FILE, ~/.edu_mcp/.env, or local .env)
Variable Description
EDU_PLATFORM Active platform: pronote, ecoledirecte, or skolengo.
PRONOTE_MCP_HOME Custom directory for .env, session cache, and logs (default: ~/.edu_mcp).
PRONOTE_ENV_FILE Explicit path to a .env file.
PRONOTE_URL Full Pronote web space URL (eleve.html or parent.html).
PRONOTE_USERNAME / PRONOTE_TOKEN Username and durable token (auto-generated).
PRONOTE_ACCOUNT_PIN Optional 4-digit 2FA PIN.
EDU_ED_CN / EDU_ED_CV ÉcoleDirecte trusted 2FA device tokens.
EDU_SKOLENGO_TOKEN / EDU_SKOLENGO_REFRESH_TOKEN Skolengo OAuth2 tokens.
PRONOTE_DOWNLOAD_DIR Directory for downloaded attachments and exports (default: ./downloads).

Development

git clone https://github.com/jujukingg/edu-mcp.git
cd edu-mcp
pip install -e ".[dev]"
pytest tests/unit -v

Released under the MIT License.

Metadata

Release files for edu-mcp 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for edu-mcp 1.0.0
File Size Uploaded Provenance Actions
edu_mcp-1.0.0.tar.gz 397.9 kB With provenance Details for edu_mcp-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for edu-mcp 1.0.0
File Interpreter ABI Platform Actions
edu_mcp-1.0.0-py3-none-any.whl Python 3 none any Details for edu_mcp-1.0.0-py3-none-any.whl

Total release size: 457.5 kB

Release files / edu_mcp-1.0.0.tar.gz

Download URL edu_mcp-1.0.0.tar.gz
Size 397.9 kB
Tags Source
SHA-256 checksum
How to use checksums
eae2a84786a9f500ec125a2cb008393ff19ab7e5c8b6bd6f261634942aeac510
BLAKE2b-256 checksum
How to use checksums
ee9584b7d082efa712321ade274d2166355a8d177beba2a55f1e68d7a927dca6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / edu_mcp-1.0.0-py3-none-any.whl

Download URL edu_mcp-1.0.0-py3-none-any.whl
Size 59.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c10abd879e06a606dd29f7dfb63155cd27cc139c75d05ce39c6fe5080ced2c17
BLAKE2b-256 checksum
How to use checksums
4d21c8638775b3324b778a536676afa8235339a5a3d5f81ad39061d07509a13f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for edu-mcp 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for edu_mcp-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page