myGES API : CLI, bibliothèque Python et doc Swagger non officielles

myGES dans ton terminal : emploi du temps, notes, supports de cours en un clic, alertes sur ton téléphone. Pour les étudiants de l'ESGI et des autres écoles du Réseau GES qui utilisent myGES. Avec la documentation Swagger complète de l'API myGES.

Projet non officiel, sans lien avec Kordis ni le Réseau GES.

Installation

sudo apt install pipx && pipx ensurepath     # puis ouvrir un nouveau terminal
pipx install "myges-api[cli]"
myges login

macOS, Windows, Arch / Omarchy (uv), mise à jour : installation.

Utilisation

Tape simplement myges : un menu plein écran s'ouvre, avec ton prochain cours, ta moyenne, ta prochaine échéance, et tout le reste au clavier (agenda à la semaine, notes avec simulation, projets, syllabus, actualités…).

myges                        # le menu interactif
myges next                   # ton prochain cours, salle, prof
myges agenda                 # la semaine
myges grades                 # tes notes
myges files --download       # tous les supports de cours, rangés par matière
myges teachers --mail python # écrire à ton prof de Python (brouillon Outlook)
myges --help                 # tout le reste

Toutes les commandes : docs/cli.md.

Alertes

Une nouvelle note, un nouveau support, un cours annulé ? Reçois-le sur ton téléphone, Discord ou par e-mail : alertes.

Assistant (Claude)

« Quelle est ma moyenne ? », « En quelle salle est mon cours de Python ? », « Écris au prof que j'ai oublié Edusign » : pose tes questions à Claude grâce au serveur MCP, dans Claude Code, Claude Desktop, ou sur le web et le mobile : assistant.

Google Calendar

Ton emploi du temps dans Google Calendar, toujours à jour : synchro Google Calendar.

Questions fréquentes

myges gcal sync tient un agenda Google Calendar à jour tout seul (cours ajoutés, déplacés, annulés). Pour un export ponctuel vers n'importe quel agenda : myges agenda --ics cours.ics.

myges files --download : un dossier par matière. Relancer la commande ne récupère que les nouveaux supports.

myges notify add ntfy (ou Discord, e-mail) puis myges watch --install : les nouveaux supports arrivent en moins de 5 minutes.

myges events subscribe 4525 (l'id est à la fin de l'adresse de l'événement) : l'inscription part à la seconde où elles ouvrent.

Il n'est envoyé qu'au serveur d'authentification de myGES (Kordis). Ta machine garde la session (un jeton valable ~6 jours), et le mot de passe seulement si tu le demandes (--save-password, pour les alertes automatiques), dans des fichiers lisibles par toi seul. Le code est ouvert : tout se vérifie.

Pour les développeurs

Swagger · bibliothèque Python · notes sur l'API · contribuer — licence MIT.