Aller au contenu
PalmaPlan — le wiki ← PalmaPlan

La référence des tools, resources et prompts

Généré, ne pas éditer à la main. Cette page sort de scripts/reference-tools.ts, qui monte un vrai serveur PalmaPlan et lit tools/list, resources/list, resources/templates/list et prompts/list — pas d'un README recopié. scripts/reference-tools.test.ts échoue si ce fichier n'est plus le résultat exact de cette commande :

npx tsx scripts/reference-tools.ts

Compté sur le serveur réel : 101 tools, 10 resources (5 concrètes + 5 modèles paramétrés), 5 prompts.

Dont 3 réservés à la vue MCP Apps (get_schedule_page, get_changes_since, get_schedule_absences — _meta.ui.visibility: ["app"]) : le serveur ne les liste qu'à un client qui annonce l'extension io.modelcontextprotocol/ui, et l'hôte les cache au modèle. Un client sans MCP Apps (Claude Code) voit les 98 tools du modèle.

Tools (101)

Plannings

create_schedule

Crée un planning vierge : timeline au jour, semaine de cinq jours, trois colonnes texte. Avec « from_template » (un template, par nom ou identifiant) et « start_date » : une copie du template dont tout est décalé en unités ouvrées, jour 0 = start_date (S8).

ParamètreTypeObligatoireDescription
namestringoui
left_border_datestringnonDate ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z
from_templatestringnonLe template (nom ou identifiant)
start_datestringnonLe jour 0 du nouveau planning, avec from_template

get_schedule

Lit un planning en entier : groupes, lignes, dates calculées, durées, avancement.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

get_conflicts

Les conflits d un planning : blocs d une même ligne qui se recouvrent, et dépendances dont la contrainte n est pas tenue. « Aucun conflit » sinon.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

update_schedule

Renomme un planning ou change ses réglages : notes, zoom par défaut (codes v23 : 3=mois, 4=semaine, 6/8/9/10=jour, 11=heure, 12/13/14=minutes), mode de propagation (forward, le seul connu), bord gauche de la timeline, largeur du panneau gauche.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
namestringnon
notesstringnon
default_zoomintegernon
propagation_modestring (forward)non
left_border_datestringnonLa date au bord gauche de la timeline
left_panel_widthintegernonEn pixels

Groupes

add_group

Ajoute un groupe — une phase du projet. Les lignes se rattachent à un groupe.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
labelstringoui
colorstringnonCouleur hexadécimale, sans dièse
afterstringnonIdentifiant du groupe après lequel insérer

update_group

Change le libellé, la couleur ou le repliement d un groupe.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
groupstringoui
labelstringnon
colorstringnonCouleur hexadécimale, sans dièse
foldedbooleannon

move_group

Déplace un groupe. Sans « after », il passe en tête.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
groupstringoui
afterstring | nullnon

delete_group

Supprime un groupe et tout ce qu il porte : lignes, cellules, blocs, dépendances.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
groupstringoui

Lignes

add_rows

Ajoute des lignes à un groupe, avec leurs cellules et leurs blocs. C est le tool de construction principal.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
groupstringoui
afterstringnonIdentifiant de la ligne après laquelle insérer
rowsobject[]oui

move_rows

Déplace des lignes, éventuellement vers un autre groupe.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowsstring[]oui
groupstringoui
afterstring | nullnon

indent_rows

Indente des lignes d un cran : elles deviennent filles de la ligne au-dessus.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowsstring[]oui

outdent_rows

Désindente des lignes d un cran. Leurs descendantes remontent avec elles.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowsstring[]oui

Le presse-papiers

copy_rows

Copie des lignes — avec leurs cellules, blocs, marqueurs, icônes, commentaires et les liens entre elles — dans un fragment à coller par paste_rows, dans ce planning ou dans un autre. Rien n est écrit ; les liens qui sortent de la sélection sont laissés et comptés.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowsstring[]oui

paste_rows

Colle un fragment de copy_rows sous une ligne (ou en fin de groupe), dans ce planning ou dans un autre : identifiants neufs, liens internes conservés. Dans un autre planning, les cellules trouvent leur colonne par libellé et type, les statuts par nom ; ce qui n a pas de place est abandonné et nommé — jamais une colonne créée d office. Une commande fragment.paste, annulable.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
fragmentobjectouiLe « fragment » rendu par copy_rows, tel quel
groupstringoui
afterstring | nullnonLa ligne sous laquelle coller ; null pour le début du groupe ; absent pour la fin

delete_rows

Supprime des lignes et ce qu elles portent : cellules, blocs, dépendances, commentaires.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowsstring[]oui

Colonnes et cellules

add_column

Ajoute une colonne au panneau gauche. Les colonnes de dates et de durée sont calculées et ne se saisissent pas.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
typestring (text | symbol | trafficlight | startdate | enddate | duration | progress | status | autonumber)oui
labelstringoui
widthintegernon
afterstringnon

delete_column

Supprime une colonne et ses cellules. La dernière colonne visible ne peut pas être supprimée.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
columnstringoui

set_cell

Écrit la valeur d une cellule. La valeur est contrôlée contre le type de la colonne ; dans une colonne de statut, le nom du statut convient.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowstringouiIdentifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé »
columnstringoui
valuestringoui

update_column

Modifie une colonne : libellé, type, largeur, affichage, valeur par défaut, ou le port de l indentation. Changer le type vide les cellules que le nouveau type refuse.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
columnstringoui
labelstringnon
typestring (text | symbol | trafficlight | startdate | enddate | duration | progress | status | autonumber)non
widthintegernon
hiddenbooleannon
indentbooleannonFait porter à cette colonne le décalage visuel de l indentation. Une seule à la fois.
default_valuestring | nullnon

move_column

Déplace une colonne. Sans « after », elle passe en première position.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
columnstringoui
afterstringnon

set_column_statuses

Définit la liste complète des statuts d une colonne de statut, dans l ordre. Les statuts absents de la liste sont retirés, et les cellules qui les portaient sont vidées.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
columnstringoui
statusesobject[]oui

set_cell_style

Met en forme une cellule : gras, italique, barré, couleur du texte et du fond. Un champ omis ne change pas ; une couleur à null la retire. Styler n est pas saisir : une colonne calculée l accepte.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowstringouiIdentifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé »
columnstringoui
boldbooleannon
italicbooleannon
strikebooleannon
text_colorstring | nullnon
background_colorstring | nullnon

Timeline

update_timeline

Règle la timeline : granularité, jours ouvrés, plage horaire, en-têtes affichés.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
typestring (day | hour | minutes15 | minutes10 | minutes5)non
active_daysboolean[]nonSept booléens, indice 0 = dimanche
hide_weekend_daysbooleannon
first_week_day0 | 1 | 6non
active_hour_fromintegernon
active_hour_tointegernon
mark_todaybooleannon
shade_daysboolean[]nonJours ombrés à l écran, indice 0 = dimanche. Sans effet sur les durées.
weekend_shade_colorstring | nullnonCouleur d ombrage, RRGGBBAA
show_yearbooleannon
show_monthbooleannon
show_week_nrbooleannon
show_datebooleannon
show_week_daybooleannon
time_formatstring (24hour | 12hour)non

add_special_dates

Marque des jours chômés ou colorés — jours fériés, fermetures, absences. Une plage annuelle se rejoue chaque année. « label » la nomme (« Fermeture d août », « Congés Anne ») ; « rows » la restreint à des lignes (par libellé ou identifiant) : une absence ne chôme que ces lignes, une journée colorée ne les teinte qu elles. Une plage chômée allonge les blocs qu elle traverse et pousse leurs successeurs contraignants ; « propagate: false » les laisse.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
datesobject[]oui
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

remove_special_dates

Retire des jours chômés ou colorés.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
datesstring[]oui

Blocs

add_period

Pose un bloc sur une ligne. Une date hors créneau ouvré est ramenée au créneau suivant, et le déplacement est signalé.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowstringouiIdentifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé »
startstringouiDate ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z
durationintegerouiEn unités de la timeline
colorstringnonCouleur hexadécimale, sans dièse
labelstringnon
progressintegernonAvancement, 0 à 100

move_periods

Décale des blocs. Soit d un nombre d unités ouvrées, soit vers une date précise pour un bloc unique.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodsstring[]oui
deltaintegernonEn unités ouvrées ; négatif pour avancer
tostringnonDate cible ; un seul bloc à la fois
rowstringnonNouvelle ligne ; un seul bloc à la fois
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

resize_period

Change la durée d un bloc, et éventuellement son début. duration_unit ré-exprime l unité du bloc : un bloc compté en semaines auquel on demande 10 jours doit la recevoir, sans quoi les 10 seraient lus comme 10 semaines.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodstringoui
durationintegeroui
duration_unitstring (day | week | month | hour | minutes15 | minutes10 | minutes5)nonL unité dans laquelle duration se compte ; celle du bloc si omise
startstringnonDate ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

update_periods

Change la couleur, le libellé, l avancement ou le verrou de blocs. locked: true fige la place et l existence du bloc (move_periods, resize_period, delete_periods et la propagation le laissent où il est, refusés ELEMENT_LOCKED) ; le libellé, la couleur, l avancement, les commentaires et les actions restent libres ; locked: false le rend.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodsstring[]oui
colorstringnonCouleur hexadécimale, sans dièse
labelstringnon
progressinteger | nullnonnull retire le suivi
lockedbooleannontrue : le bloc ne bouge plus et ne se supprime plus ; false : le libère

delete_periods

Supprime des blocs, avec leurs dépendances et leurs commentaires.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodsstring[]oui

Icônes

add_symbol

Pose une icône — jalon, coche, alerte, réunion… — sur une ligne, à une date. Le code se trouve avec list_symbol_types. Une date hors créneau ouvré est ramenée au créneau suivant, et le déplacement est signalé.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowstringouiIdentifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé »
atstringouiDate ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z
typeinteger | integer | stringouiCode d icône v23, 1 à 91 (list_symbol_types les nomme et les cherche) ; ou une icône personnalisée du planning (S9) : son code négatif, ou le nom de son fichier
labelstringnon

move_symbol

Déplace une icône : vers une date précise, ou d un nombre d unités ouvrées. Éventuellement vers une autre ligne.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
symbolstringouiIdentifiant, libellé, ou « ligne @ date-ou-libellé » — « 1.2 @ 2026-10-16 » ; sur une timeline horaire, l heure départage : « 1.2 @ 2026-10-16 14:00 »
tostringnonDate cible
deltaintegernonEn unités ouvrées ; négatif pour avancer
rowstringnonNouvelle ligne
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

update_symbol

Change le type, le libellé ou le verrou d icônes. locked: true fige la place et l existence du jalon (move_symbol, delete_symbol et la propagation le laissent où il est, refusés ELEMENT_LOCKED) ; locked: false le libère.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
symbolsstring[]oui
typeinteger | integer | stringnonCode d icône v23, 1 à 91 (list_symbol_types les nomme et les cherche) ; ou une icône personnalisée du planning (S9) : son code négatif, ou le nom de son fichier
labelstringnon
lockedbooleannontrue : le jalon ne bouge plus et ne se supprime plus ; false : le libère

delete_symbol

Supprime des icônes, avec leurs dépendances et leurs commentaires.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
symbolsstring[]oui

list_symbol_types

Les 91 types d icônes du format v23 — code, nom, mots-clés —, filtrés par un mot en français ou en anglais. Sans « search », la table entière. Avec « schedule », les icônes personnalisées de ce planning (S9) à la suite : code négatif, fichier, taille.

ParamètreTypeObligatoireDescription
searchstringnon« réunion », « meeting », « alerte »…
schedulestringnonLe planning dont on veut aussi les icônes personnalisées (code négatif, nom de fichier)

Dépendances

add_dependency

Lie deux blocs ou icônes : la cible ne peut pas commencer (ou finir) avant l origine, plus un décalage. Si la cible est placée trop tôt, elle est poussée du minimum nécessaire, et la réponse le dit ; propagate: false pose le lien sans la bouger, et get_conflicts le montre violé. mode: soft trace un lien indicatif — un trait qui ne déplace rien et n est jamais violé.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
fromstringouiIdentifiant, libellé d un bloc ou d une icône, ou « ligne @ date-ou-libellé » — avec l heure sur une timeline horaire
tostringouiIdentifiant, libellé d un bloc ou d une icône, ou « ligne @ date-ou-libellé » — avec l heure sur une timeline horaire
typestring (fs | ss | ff | sf)nonfs fin→début (défaut), ss début→début, ff fin→fin, sf début→fin
lagintegernonDécalage en unités ouvrées de la timeline — jours ouvrés sur une timeline au jour, heures ouvrées sur une timeline horaire ; négatif pour faire chevaucher ; 0 par défaut
modestring (hard | soft)nonhard (défaut) : contraignant — la cible est poussée quand la contrainte n est plus tenue, le lien compte dans get_conflicts, le chemin critique et what_if ; soft : indicatif — un trait qui ne déplace rien, jamais violé, hors du chemin critique, qui peut fermer une boucle
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

update_dependency

Change le type, le décalage ou le mode d une dépendance. Les extrémités ne se changent pas : on supprime et on relie. Si la nouvelle contrainte n est plus tenue, la cible est poussée du minimum nécessaire ; propagate: false la laisse en place. mode: hard rend le lien contraignant (il pousse aussitôt, et un cycle est refusé) ; mode: soft le rend indicatif (rien ne bouge).

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
dependencystringouiIdentifiant de la dépendance, ou « origine → cible » (deux références d éléments)
typestring (fs | ss | ff | sf)nonfs fin→début (défaut), ss début→début, ff fin→fin, sf début→fin
lagintegernonDécalage en unités ouvrées de la timeline — jours ouvrés sur une timeline au jour, heures ouvrées sur une timeline horaire ; négatif pour faire chevaucher ; 0 par défaut
modestring (hard | soft)nonhard (défaut) : contraignant — la cible est poussée quand la contrainte n est plus tenue, le lien compte dans get_conflicts, le chemin critique et what_if ; soft : indicatif — un trait qui ne déplace rien, jamais violé, hors du chemin critique, qui peut fermer une boucle
propagatebooleannonVrai par défaut : les successeurs liés sont poussés du minimum nécessaire ; false pour déplacer sans rien entraîner

delete_dependency

Supprime une dépendance. Les blocs restent où ils sont.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
dependencystringouiIdentifiant de la dépendance, ou « origine → cible » (deux références d éléments)

Commentaires

set_comment

Écrit un commentaire sur un bloc, une icône ou une cellule. Une cible ne porte qu un commentaire : s il en existe un, il est remplacé. Un corps vide est refusé ; delete_comment retire.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
targetobject | object | objectoui{ period } | { symbol } | { row, column }
bodystringoui

delete_comment

Retire le commentaire d un bloc, d une icône ou d une cellule.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
targetobject | object | objectoui{ period } | { symbol } | { row, column }

reply_comment

Répond sous le commentaire d un bloc, d une icône ou d une cellule (set_comment pose la tête). Avec « reply_id » : modifie cette réponse (« body ») ou la retire (« delete: true »). Une réponse est signée de qui l écrit ; 200 réponses par fil, 10 000 caractères.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
targetobject | object | objectoui{ period } | { symbol } | { row, column }
bodystringnon
reply_idstringnonLa réponse à modifier ou à retirer
deletebooleannonAvec reply_id : retire la réponse

resolve_comment

Clôt le fil d un commentaire (« resolved: true » — le triangle passe au gris), ou le rouvre (« resolved: false »). Réservé à qui édite le planning.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
targetobject | object | objectoui{ period } | { symbol } | { row, column }
resolvedbooleanoui

Légende

update_legend

Affiche ou masque la légende, et nomme les couleurs de blocs.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
displaybooleannon
periodsobject[]non

Chercher, la date de référence, les données projet

search_schedule

Cherche dans un planning avec les critères du filtre de l éditeur (page 03 §7) : texte libre (cellules, libellés de blocs et d icônes, commentaires), couleurs de blocs, types d icônes, couleurs de fond de cellule, feux, statuts (par nom ou identifiant), plage de dates. OU entre les valeurs d un critère, ET entre critères. Rend les lignes trouvées et, par ligne, les blocs et icônes qui correspondent — le même moteur que le volet Filtre.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
textstringnonTexte cherché, sans accent ni casse
colorsstring[]nonCouleurs de blocs
symbolsinteger[]nonTypes d icônes v23
backgroundsstring[]nonCouleurs de fond de cellule
lightsinteger[]nonFeux : 0 aucun, 1 rouge, 2 orange, 3 vert
statusesstring[]nonStatuts, par nom ou identifiant
fromstringnonDébut de la plage, inclus
tostringnonFin de la plage, incluse

update_reference_date

La date de référence (le trait vertical de la timeline) : la poser ou la déplacer (date), l afficher ou la masquer (visible), la retirer (clear). Une date hors créneau ouvré est ramenée au suivant, et la réponse le dit.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
datestringnonLa date du trait
visiblebooleannon
clearbooleannonVrai pour retirer le trait

update_metadata

Remplace les données projet affichées dans la légende (paires libellé / valeur : client, chef de projet, version…) par la liste donnée, dans cet ordre. Une liste vide les retire toutes.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
entriesobject[]oui

Les actions d’un bloc

list_actions

Les actions des blocs d un planning — le « comment » de chaque tâche — bloc par bloc : ○ à faire, ◐ en cours, ✓ fait, avec le responsable. « period » restreint à un bloc, « assignee » à un responsable (« me » : les vôtres), « status » à un statut.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodstringnonUn bloc : libellé, identifiant, ou « ligne @ date »
assignee"me" | object | object | object | nullnon« me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer
statusstring (todo | doing | done)nontodo (à faire), doing (en cours), done (fait)

add_action

Ajoute une action à faire sur un bloc — un titre, un contexte (Markdown léger : gras, italique, liens), un responsable. Dès qu un bloc a une action, son avancement est déduit de ses actions (faites / total) et ne se règle plus à la main. Répond avec le nouvel avancement du bloc.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodstringouiLe bloc : libellé, identifiant, ou « ligne @ date »
titlestringoui
contextstringnonLe contexte de l action, en Markdown léger
assignee"me" | object | object | object | nullnon« me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer
statusstring (todo | doing | done)nontodo par défaut
afterstring | nullnonL action après laquelle insérer ; null pour insérer en tête ; absent : à la fin

update_action

Modifie une action : son titre, son contexte, son responsable, son statut, et son bloc (« period », S23 — l avancement des deux blocs suit, déduit de leurs actions). Pour le seul statut, set_action_status suffit ; pour la seule place dans la colonne, after seul suffit.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actionstringouiIdentifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc
titlestringnon
contextstringnon
assignee"me" | object | object | object | nullnon« me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer
statusstring (todo | doing | done)nontodo (à faire), doing (en cours), done (fait)
periodstringnonLa déplacer vers un autre bloc — libellé, identifiant, ou « ligne @ date » (S23). Avec after, qui désigne alors une action de ce bloc d arrivée
afterstring | nullnonLa place dans la colonne — dans le bloc d arrivée si period est posé, sinon dans le sien. null pour la mettre en tête

set_action_status

Change le statut d une action — done la termine, doing la passe en cours, todo la rouvre — et répond avec le nouvel avancement du bloc, déduit de ses actions.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actionstringouiIdentifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc
statusstring (todo | doing | done)ouitodo (à faire), doing (en cours), done (fait)

delete_action

Retire une action de son bloc. La dernière retirée rend au bloc un avancement qui se règle à la main.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actionstringouiIdentifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc

list_my_actions

Ce qui vous est confié — à vous-même (votre jeton nommé), ou à l utilisateur sinon — dans tous les plannings que vous pouvez lire, regroupé par planning. « status » restreint à un statut. « since » : reprenez le « as_of » d un appel précédent pour voir ce qui est neuf, changé, ou retiré (avec la raison) depuis — la réponse rend toujours un as_of neuf, à repasser au prochain appel : c est ce qui fait marcher « depuis ma dernière visite ».

ParamètreTypeObligatoireDescription
statusstring (todo | doing | done)nontodo (à faire), doing (en cours), done (fait)
sincestringnonL as_of rendu par un appel précédent de list_my_actions

get_action_history

L histoire d une action : sa création, chaque changement de colonne, de responsable, de titre ou de contexte, un déplacement vers un autre bloc, une suppression ou une restauration — qui et quand —, et le temps passé dans chaque colonne.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actionstringouiIdentifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc

Ce qui coince, l’état du kanban

get_action_alerts

Ce qui coince dans le kanban : une action non faite dont le bloc est terminé (en retard), une action « en cours » depuis idle_days jours sans changer (immobile, sept jours par défaut), une action sans responsable dans un bloc déjà commencé, ou confiée à quelqu un d absent pendant son bloc. Sans « schedule » : toutes vos alertes, tous les plannings que vous pouvez lire confondus ; avec : celles d un planning entier.

ParamètreTypeObligatoireDescription
schedulestringnonUn planning ; sans lui, vos alertes dans tous ceux que vous pouvez lire
idle_daysintegernonJours sans changer avant « immobile » ; sept par défaut

get_kanban_status

L état du kanban d un planning : combien d actions dans chaque colonne, ce qui a bougé cette semaine (qui, de quoi à quoi, quand), et ce qui coince — les mêmes alertes que get_action_alerts.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
idle_daysintegernonJours sans changer avant « immobile » ; sept par défaut

Les absences et les risques

list_absences

Les absences — congés, temps partiel, formation, autre ; jamais un motif médical, le schéma le refuse. Sans « schedule » : les vôtres, par /me/absences. Avec un planning : celles de ses membres actuels, par la même visibilité que l écran Agenda — un étranger ou un ancien membre n y voit rien, même avec un nom gardé sur une ligne ou une action.

ParamètreTypeObligatoireDescription
schedulestringnonUn planning, pour voir les absences de ses membres plutôt que les vôtres

add_absence

Pose une de vos absences. Trois formes : un jour ou une demi-journée, une période longue (« forme: periode »), ou des jours récurrents (« forme: recurrente » — tous les vendredis, un vendredi sur deux…). Le motif est congés, temps_partiel, formation ou autre — AUCUN motif médical et AUCUN champ libre : le schéma les refuse (donnée de santé, RGPD art. 9 ; un outil de planning n a besoin de savoir que vous êtes absent, jamais pourquoi). Ne déplace aucun bloc, d aucun planning : get_schedule_risks dit ce qu elle met en risque.

ParamètreTypeObligatoireDescription
motifstring (conges | temps_partiel | formation | autre)ouicongés, temps_partiel, formation ou autre — jamais un motif médical
formeobject | objectoui

remove_absence

Retire une de vos absences, par son identifiant (list_absences les donne) — ou par un bout de sa description si elle est seule à correspondre.

ParamètreTypeObligatoireDescription
absencestringouiIdentifiant d une absence, ou un bout de sa description — list_absences les donne

get_schedule_risks

Les blocs à risque d un planning : qui y travaille (une ligne reliée par set_row_member, ou une action confiée) est absent sur au moins un jour ouvré de sa durée — même liste, même calcul que l écran Risques. Une ligne reliée à un membre qui n est plus du planning est signalée à part, sans date.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

set_row_member

Relie une ligne à un membre du planning : tous ses blocs comptent alors pour cette personne dans get_schedule_risks — la disposition « une ligne par personne ». « member » : « me », un nom, un e-mail, ou un identifiant (list_members les donne) ; null délie la ligne.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
rowstringouiIdentifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé »
memberstring | nulloui« me », un nom, un e-mail, un identifiant — list_members les donne ; null pour délier

Les plannings (cycle de vie)

list_schedules

La liste des plannings : nom, taille, dernière modification et par qui (vous ou Claude). « trash » liste la corbeille avec la date de purge, « templates » les modèles.

ParamètreTypeObligatoireDescription
trashbooleannonLa corbeille plutôt que la liste
templatesbooleannonLes templates plutôt que les plannings

delete_schedule

Met un planning à la corbeille : il n y est plus lisible ni modifiable, et sera purgé trente jours plus tard ; restore_schedule le rend d ici là.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

restore_schedule

Rend à la liste un planning mis à la corbeille, tel qu il était.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

duplicate_schedule

Copie un planning en entier — groupes, lignes, blocs, icônes, liens, commentaires, légende — avec des identifiants neufs, au rang 0 et sans histoire. Nommé « Copie de … » sauf nom donné.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
namestringnon

Les versions

list_versions

Les versions d un planning, la plus récente d abord : date, raison (daily, before_bulk, manual, restore), rang et libellé. restore_version en rend une, diff_versions { from_version, to_version } compare deux.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

create_version

Prend une version manuelle du planning tel qu il est, avec un libellé facultatif — avant une opération qu on voudrait pouvoir défaire d un coup.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
labelstringnon

restore_version

Restaure une version — par son identifiant ou son libellé exact. Une commande schedule.replace au journal, que undo défait ; l état d avant reste en version « restore ».

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
versionstringouiIdentifiant ou libellé

set_baseline

Désigne une version comme référence (baseline) du planning : les blocs déplacés depuis portent une ombre à leur ancienne place (écran, SVG, PNG, impression), l inspecteur dit l écart, et diff_versions { from_version: "baseline" } le compare. Sans version : une version « Référence » est prise maintenant, puis désignée. Annulable par undo.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
versionstringnonLa version à désigner, par identifiant ou libellé exact ; sinon, une version prise maintenant

clear_baseline

Retire la référence (baseline) du planning : plus d ombre, plus d écart. La version, elle, reste. Annulable par undo.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

replace_schedule

Remplace le contenu entier d un planning par un modèle PalmaPlan complet (la forme de palmaplan://schedule/{id}/json, sans l identité : ni id, owner_id, created_at, seq, ni is_template, deleted_at). Validé comme un import ; l état d avant reste en version before_bulk, et undo y revient.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
modelobjetouiLe modèle entier, sans identité

Les gabarits

save_as_template

Enregistre une copie du planning comme template : il quitte la liste principale pour la galerie, et create_schedule { from_template, start_date } en fait des plannings dont tout est décalé en unités ouvrées. Nommé comme le planning sauf nom donné.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
namestringnon

list_templates

La galerie des templates : nom, taille, jour 0. Comme list_schedules { templates: true }.

_Aucun paramètre._

L’impression et les ressources

update_print_setup

Règle la mise en page d impression du planning — format, orientation, ajustement, plage, légende, commentaires — celle que l écran Imprimer et render_schedule { paper: {} } utilisent. Une commande print_setup.update, annulable.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
formatstring (A4 | A3 | A2 | A1 | A0 | letter | legal | ledger)non
orientationstring (landscape | portrait)non
zoom_to_fitbooleannon
range_startstring | nullnon
range_endstring | nullnon
include_legendbooleannon
include_commentsbooleannon
show_critical_pathbooleannonLe liseré du chemin critique à l impression et dans render_schedule (S9)
show_baselinebooleannonLes ombres de la référence à l impression et dans render_schedule (S9)

set_logo

Le logo du planning, montré dans la légende, le SVG, le PNG et l impression. « file » téléverse un PNG, JPEG ou GIF (50 Ko, 185 px de large au plus) en base64 et le pose ; « asset » pose un fichier déjà téléversé ; « show » et « height » règlent ; « remove » retire. Une commande logo.update, annulable.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
fileobjectnon
assetstringnonL identifiant d un fichier déjà téléversé
showbooleannon
heightintegernonLa hauteur affichée, en pixels
removebooleannon

delete_asset

Supprime un fichier téléversé (un logo) du planning ; le logo qui le montrait est retiré avec lui. Une commande asset.remove, annulable. Les fichiers sont listés dans palmaplan://schedule/{id}/json (assets).

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
assetstringouiL identifiant du fichier

Les marqueurs

add_marker

Pose un marqueur dans un bloc, à une date (AAAA-MM-JJ), avec un libellé et un genre facultatifs. Refusé s il tombe hors du bloc. Il suit le bloc qui se déplace ; l export Tom s Planner ne le porte pas.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
periodstringouiLe bloc, par libellé, « ligne @ date » ou identifiant
atstringouiDate ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z
labelstringnon
kindstringnon

update_marker

Renomme un marqueur, ou change son genre. Par son identifiant, ou par son libellé exact.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
markerstringouiIdentifiant ou libellé du marqueur
labelstringnon
kindstringnon

remove_marker

Retire un marqueur, par son identifiant ou son libellé exact ; undo le rend.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
markerstringoui

Le partage

list_members

Qui a accès à un planning : le propriétaire, les membres (éditeur ou lecteur), les invitations en attente, et votre propre rôle.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

share_schedule

Partage un planning avec quelqu un par son e-mail, en éditeur ou en lecteur. Un e-mail dont le compte a prouvé son adresse devient membre tout de suite ; sinon, une invitation part à cette adresse et son lien est rendu ici (à transmettre — il vaut sept jours). Un membre déjà là change de rôle.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
emailstringouiL e-mail de la personne
rolestring (editor | viewer)ouieditor modifie tout ; viewer lit seulement

unshare_schedule

Retire l accès de quelqu un à un planning — par son e-mail, ou par l identifiant d une invitation en attente (list_members les donne).

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
emailstringnonLe membre à retirer
invitationstringnonL invitation en attente à révoquer

La publication

publish_schedule

Publie un planning en lecture seule : une adresse /p/<slug> que n importe qui peut ouvrir, toujours à jour ; un mot de passe facultatif ; l intégration en iframe permise ou non ; l agenda des absences montré ou non (les noms des membres et leurs dates, jamais le motif — ?vue=agenda). Avec l intégration, ?embed=1&vue=gantt|kanban|agenda s encadre. Republier après unpublish_schedule donne une autre adresse.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
passwordstringnonUn mot de passe à demander ; absent, la page est ouverte
allow_embedbooleannonPermettre l intégration en iframe (faux par défaut)
show_absencesbooleannonMontrer l agenda des absences sur le lien : quiconque a le lien voit les noms des membres et leurs dates d absence, jamais le motif (faux par défaut ; absent, inchangé)

unpublish_schedule

Dépublie un planning : son adresse publique ne mène plus nulle part.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

En masse

build_schedule

Crée un planning complet en un appel : groupes, lignes, cellules, blocs et dépendances entre blocs. C'est le tool à utiliser pour construire un planning depuis une description de projet.

ParamètreTypeObligatoireDescription
namestringoui
start_datestringouiPremier jour du planning, YYYY-MM-DD. Sert de repère aux offsets.
timelineobjectnon
columnsobject[]nonColonnes du panneau gauche. Par défaut : Activité, Responsable, Notes.
holidaysobject[]nonJours chômés — fériés, fermetures, absences (avec « rows »)
groupsobject[]oui

apply_patch

Applique un lot de commandes brutes du moteur, atomiquement. Pour ce que les tools métier ne couvrent pas. Utilisez dry_run pour voir les effets sans écrire, et expected_rank pour n écrire que si le planning n a pas changé depuis votre lecture (STALE_BASE sinon, rien n est écrit).

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
commandsobject[]oui
dry_runbooleannon
expected_rankintegernonLe rang auquel vous avez lu ou simulé le planning (le rank de what_if) : le lot n est appliqué que si le planning y est toujours — sinon STALE_BASE, et rien n est écrit

shift_schedule

Décale tout le planning d'un nombre d'unités de la timeline — des jours ouvrés sur une timeline au jour, des heures ouvrées sur une timeline horaire. Les créneaux chômés sont sautés, et les écarts entre blocs conservés. Ne propage jamais : tout bouge du même pas, et une dépendance violée avant l'est encore après.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
deltaintegerouiEn unités de la timeline du planning ; négatif pour avancer le planning. Lisez la timeline si vous n'êtes pas sûr de l'unité.

L’échange (import / export)

import_schedule

Importe un planning depuis un texte et le crée en entier : « v23 » pour le format JSON v23, « palmaplan » pour un export JSON PalmaPlan, « csv » (une ligne par activité, en-têtes reconnues ou mapping explicite — avec un mapping, seules les colonnes nommées sont interprétées, les autres sont du texte), « ics » (un événement par ligne, les récurrences non développées), « msproject_xml » (MSPDI : tâches, niveaux, liens). Rend le rapport de conversion — ce qui a été dégradé, ignoré, aligné ou pris par défaut — et l identifiant du planning créé.

ParamètreTypeObligatoireDescription
formatstring (v23 | palmaplan | csv | ics | msproject_xml)oui
contentstringouiLe contenu du fichier, tel quel
namestringnonLe nom du planning ; sinon une donnée projet du fichier, sinon « Planning importé »
mappingobjectnonCSV seulement : quelle en-tête porte quoi
timelinestring (day | hour)nonICS seulement : au jour (défaut) ou horaire

export_schedule

Exporte un planning : « v23 » (le format JSON v23), « palmaplan » (le modèle complet, réimportable tel quel), « markdown » (la vue lisible), « csv » (une ligne par ligne : colonnes saisies, groupe, début, fin, durée, avancement — UTF-8 avec BOM, point-virgule, pour Excel), « xlsx » (S9 : un classeur à trois feuilles — Planning, le tableau du CSV avec de vraies dates ; Gantt, une colonne par jour, chaque bloc en cellules de sa couleur ; Actions (S10), une ligne par action — rendu en pièce jointe base64). Le premier bloc de la réponse résume et liste ce que le format ne sait pas dire ; le second est le fichier.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
formatstring (v23 | palmaplan | markdown | csv | xlsx)oui

Le rendu (SVG, PNG, PDF)

render_schedule

Rend un planning en image : « svg » (natif, le même dessin que l écran), « png » ou « pdf » (par Chromium ; sans lui, le SVG est rendu et le tool le dit). Le texte dit la plage et le cran retenus ; le PNG est rendu en image et en base64, le PDF en fichier incorporé et en base64.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
formatstring (svg | png | pdf)oui
rangeobjectnonLa plage montrée, AAAA-MM-JJ ; sinon toute la période du planning
zoomintegernonLe cran (codes : 3 mois, 4 semaine, 6/8/9/10 jour, 11 heure, 12/13/14 quarts d heure et moins) ; sinon le plus fin qui fasse tenir la plage
include_legendbooleannonLe bandeau de légende ; par défaut, le réglage du planning
include_commentsbooleannonL annexe des commentaires, numérotés comme les repères du dessin
include_actionsbooleannonL annexe des actions : par bloc, cochées, avec leur responsable (S10)
critical_pathbooleannonLe liseré rouge du chemin critique (S9) — le même calcul que get_critical_path ; par défaut, la mise en page du planning (show_critical_path)
baselinebooleannonLes ombres de la référence (S9, set_baseline) sous les blocs déplacés ; par défaut, la mise en page du planning (show_baseline). Sans référence désignée, rien.
widthintegernonLa largeur en pixels, 1 200 par défaut
scalenumbernonPNG seulement : le facteur de définition, 2 pour un rendu Retina
paperobjectnonLe papier (S8) : le rendu part de la mise en page du planning (print_setup : plage, légende, commentaires, cran) — comme l aperçu imprimable — à la largeur de la page utile, et le PDF est mis en page dessus avec 10 mm de marge ; range, zoom, include_* et width surchargent. {} suffit pour imprimer comme l écran.

Les analyses

get_critical_path

Le chemin critique d un planning : la chaîne d éléments dont tout retard recule la fin de projet, la fin de projet, et la marge de chaque autre élément — le nombre d unités ouvrées dont il peut glisser sans rien retarder. Dates au plus tôt et au plus tard dans le contenu structuré.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

get_progress_report

Le rapport d avancement : par groupe puis par ligne, l avancement pondéré par les durées, ce qui est terminé, en cours, à venir, en retard (fini avant aujourd hui sans être à 100), ce qui est passé sans être suivi, et les jalons des prochains jours. « today » fixe la date du rapport ; sinon maintenant.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
todaystringnonLa date du rapport, YYYY-MM-DD ; sinon maintenant
horizon_daysintegernonLes jalons de ces N prochains jours ; 14 par défaut

what_if

Simule un geste sans rien écrire et dit ce qu il changerait : les éléments qui bougent (le geste et ce qu il entraîne), la nouvelle fin de projet, le nouveau chemin critique, les liens qui resteraient violés, les nouveaux risques d absence. Le geste : « move » (comme move_periods), « resize » (comme resize_period), ou « commands » (un lot brut, comme apply_patch). Dans un hôte MCP Apps, la proposition s affiche en avant/après, avec « Accepter » (apply_patch des mêmes commandes, refusé si le planning a changé depuis ; jamais offert si le lot change ce que l avant/après ne montre pas — le texte nomme alors ces changements non représentés) et « Refuser ».

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actionobject | object | objectoui

diff_versions

Les différences lisibles entre deux états d un planning — deux rangs du journal (from_seq, to_seq), ou deux versions (from_version, to_version : identifiant ou libellé ; l une des deux peut être le courant ; « baseline » désigne la référence posée par set_baseline) : lignes ajoutées ou retirées, blocs ajoutés, retirés, déplacés (de → à), redimensionnés, recolorés, liens, cellules, commentaires. Sans arrivée : jusqu au courant. Dans un hôte MCP Apps, la comparaison s affiche en avant/après, en lecture seule.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
from_seqintegernonLe rang de départ, tel que get_history le rend
to_seqintegernonLe rang d arrivée ; sinon le courant
from_versionstringnonLa version de départ (S8) ; « baseline » : la référence (S9)
to_versionstringnonLa version d arrivée ; sinon le courant

get_history

Le journal des commandes d un planning, filtré : acteur (user ou mcp), rang de départ, période, types de commande, limite. Chaque entrée : le rang, le type, l acteur, la date, et le payload résolu.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
actorstring (user | mcp)non
since_seqintegernonLes entrées de rang strictement supérieur
fromstringnonLes entrées à partir de cette date
tostringnonLes entrées jusqu à cette date, exclue
typesstring[]nonLes types de commande retenus, par exemple ["period.move"]
limitintegernonLes N dernières entrées retenues ; 50 par défaut

list_comments

Les commentaires d un planning, avec ce qu ils annotent — un bloc, une icône, une cellule —, leur auteur et leur date ; (S13) chaque fil avec ses réponses signées et son état (résolu par qui, quand). « element » restreint à un bloc ou une icône.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
elementstringnonUn bloc ou une icône : identifiant ou libellé

La vue embarquée

show_schedule

Affiche un planning dans la conversation : le Gantt de PalmaPlan, en ligne puis en plein écran, aux couleurs de l hôte (une vue MCP Apps) — ou, par view, le kanban de toutes ses actions, ou l agenda des absences de ses membres. Rend aussi un résumé textuel (période, comptes, risques) et, pour qui ne rend pas MCP Apps, l adresse de la vue, valable une heure, en lecture seule sauf editable: true. Options : la vue, un filtre, le zoom, une fenêtre de dates, le panneau, le chemin critique, la référence, editable: false pour une vue qui lit seulement.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
filterstringnonUn filtre, dans la syntaxe de l écran : t:texte, c:couleurs, s:statuts, d:début, f:fin, séparés par ;
zoomintegernonLe cran de zoom (code v23 : 8 = semaine, 9 = jour, 10 = jour large…)
fromstringnonLe premier jour visible (AAAA-MM-JJ)
tostringnonLe dernier jour visible (AAAA-MM-JJ) : avec from, la vue cadre cette fenêtre
panelstring (grid | timeline | both)nonLa grille seule, le ruban seul, ou les deux (défaut)
critical_pathbooleannonPeindre le chemin critique
referencebooleannonMontrer la version de référence (les ombres), si le planning en a une
editablebooleannonFaux : une vue qui lit seulement, même pour un éditeur. Dans un hôte MCP Apps, la vue écrit par défaut, selon le rôle ; le lien d une heure rendu aux hôtes sans MCP Apps lit seulement, sauf editable: true — le rôle réel de l utilisateur plafonne toujours
viewstring (gantt | kanban | agenda)nonCe que la vue montre : le Gantt (défaut), le kanban de toutes les actions du planning, ou l agenda des absences de ses membres

get_schedule_page

Réservé à la vue MCP Apps de PalmaPlan : une page du modèle d un planning (ou d une de ses versions), chaque réponse sous 120 000 caractères. La première page porte le planning et le début de ses collections ; suivre next_cursor jusqu à null, et mettre les collections bout à bout (un fichier coupé garde son id : ses data se concatènent).

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
cursorstringnonLe next_cursor de la page précédente ; absent, la première page
versionstringnonUne version enregistrée à lire plutôt que le planning courant (la référence, pour ses ombres)

get_changes_since

Réservé à la vue MCP Apps de PalmaPlan : les entrées du journal d un planning après le rang since (la forme de GET /schedules/:id/commands?since=), à rejouer sur le modèle. Sous 120 000 caractères : coupé, rank est celui de la dernière entrée rendue — rappeler avec since=rank jusqu à une réponse vide. STALE_BASE : trop de retard, relire le planning par get_schedule_page. absences_rev : la révision de l agenda (absences et membres, qui ne passent pas par le journal) — si elle diffère de celle de get_schedule_absences, relire l agenda.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
sinceintegerouiLe rang que la vue a déjà : les entrées du journal qui suivent

get_schedule_absences

Réservé à la vue MCP Apps de PalmaPlan : les membres actuels d un planning (nom affiché, identifiant opaque propre à la réponse) et leurs absences (la forme seule : dates, demi-journées, récurrence) — jamais le motif, ni l e-mail, ni l identifiant de compte. Les mêmes droits que l écran Agenda ; le modèle a list_absences.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient

L’annulation (undo / redo)

undo

Annule le dernier lot appliqué par cette session MCP sur ce planning (ou les N derniers) : ses inverses, lus au journal, sont appliqués en un lot. Ne connaît que ce que ce processus a écrit ; ce que l écran a fait entre-temps reste. redo rétablit.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
stepsintegernonLe nombre de lots ; 1 par défaut

redo

Rétablit le dernier lot annulé par undo dans cette session MCP sur ce planning (ou les N derniers). Une écriture nouvelle vide ce qui pouvait être rétabli.

ParamètreTypeObligatoireDescription
schedulestringouiIdentifiant du planning, ou son nom — « Migration S/4HANA » convient
stepsintegernonLe nombre de lots ; 1 par défaut

Resources (10)

Resources concrètes (5)

NomAdresseType MIMEDescription
schedulespalmaplan://schedulestext/markdownListe des plannings connus
templatespalmaplan://templatestext/markdownLes plannings enregistrés comme templates, à instancier par create_schedule { from_template, start_date }
symbolspalmaplan://symbolstext/markdownLes 91 codes d icônes du format v23, avec leurs noms et mots-clés
me-actionspalmaplan://me/actionstext/markdownLes actions qui me sont confiées, tous plannings confondus, regroupées par planning (S23)
schedule-appui://palmaplan/planningtext/html;profile=mcp-appLa vue native de PalmaPlan (MCP Apps) : le Gantt d un planning, dans la conversation — en ligne ou en plein écran, aux couleurs de l hôte. Affichée par show_schedule

Modèles de resource, paramétrés par {id} (5)

NomModèle d’adresseType MIMEDescription
schedulepalmaplan://schedule/{id}text/markdownVue lisible complète d un planning : groupes, lignes, dates, durées
schedule-jsonpalmaplan://schedule/{id}/jsonapplication/jsonModèle complet normalisé, pour les traitements exacts
schedule-historypalmaplan://schedule/{id}/historytext/markdownJournal des commandes appliquées : qui, quoi, quand
schedule-dependenciespalmaplan://schedule/{id}/dependenciestext/markdownLe graphe des dépendances d un planning : la liste, avec les liens violés marqués, et un diagramme Mermaid
schedule-actionspalmaplan://schedule/{id}/actionstext/markdownLes actions des blocs d un planning, bloc par bloc : à faire, en cours, faites, avec leur responsable (S10)

Prompts (5)

plan_project

Transforme la description d'un projet en planning complet : découpage en phases, estimation, construction en un appel.

ArgumentObligatoireDescription
descriptionouiLe projet à planifier, en texte libre. Plus c'est précis, mieux c'est.
start_datenonDate de début, YYYY-MM-DD
end_datenonÉchéance à tenir, si elle est imposée
granularitynon« phase », « activité » ou « tâche » — le grain du découpage

import_from_text

Extrait activités, dates et durées d'un texte libre — compte rendu, liste de tâches, courriel — et en fait un planning.

ArgumentObligatoireDescription
contentouiLe texte à interpréter
schedulenonPlanning à compléter. Absent, un nouveau planning est créé.

reschedule

Lit le planning, simule avec what_if ce qu'une contrainte impose — « finir avant le 15 décembre », « X absent du 3 au 10 » —, puis applique après confirmation.

ArgumentObligatoireDescription
scheduleouiLe planning : identifiant ou nom
constraintouiLa contrainte, en texte libre : une échéance, une absence, un retard connu

plan_task

Lit un bloc et son contexte, propose une liste d'actions (cinq à dix, un verbe à l'infinitif, un responsable proposé), et ne les écrit qu'après confirmation — avec add_action. L'avancement du bloc suivra les actions.

ArgumentObligatoireDescription
scheduleouiLe planning : identifiant ou nom
periodouiLe bloc : son libellé, ou « ligne @ date »

weekly_status

Un rapport d'avancement lisible : ce qui est fait, en cours, en retard, les prochains jalons et les conflits — depuis get_progress_report et get_conflicts.

ArgumentObligatoireDescription
scheduleouiLe planning : identifiant ou nom
todaynonLa date du point, YYYY-MM-DD ; sinon aujourd'hui