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.1

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.1
File Size Uploaded Provenance Actions
edu_mcp-1.0.1.tar.gz 397.9 kB With provenance Details for edu_mcp-1.0.1.tar.gz

Built distribution (wheel)

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

Total release size: 457.6 kB

Release files / edu_mcp-1.0.1.tar.gz

Download URL edu_mcp-1.0.1.tar.gz
Size 397.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f29333a66db2e05fcfe0e33616c93cf5e44e012d94af79f06c0bcc5435a438be
BLAKE2b-256 checksum
How to use checksums
3edc760dd406b78aa4546ce55c810c9fae794823906c1fd87970920310de382b
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.1-py3-none-any.whl

Download URL edu_mcp-1.0.1-py3-none-any.whl
Size 59.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ea8ceff07a690b3b8c822f4b2794ed17b30c4f94740a18043f38135a7464409f
BLAKE2b-256 checksum
How to use checksums
30d1f1c0f5fa5cd72eda50a5b77798f45683f8fe40ac74b8a1209ad50ca4d177
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.1

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.1.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.1 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