Edu MCP
The unified Model Context Protocol server for French school platforms.
Connect Pronote (+ ENT), ÉcoleDirecte, and Skolengo to your AI assistant in seconds.
Supported Platforms
|
Pronote (+ ENT) Toutatice, MonBureauNumérique, Île-de-France, Atrium… Browser SSO + 2FA + QR Token
|
ÉcoleDirecte Student & Family multi-child spaces Credentials + QCM 2FA
|
Skolengo 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 & 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"
- The assistant calls
edu_setup_accountand guides you through the exact flow for your platform. - Pronote / Skolengo: your browser opens on the official login page; sign in normally (ENT + 2FA) and your durable token is captured automatically.
- É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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.