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 littools/list,resources/list,resources/templates/listetprompts/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ètre | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | |
left_border_date | string | non | Date ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z |
from_template | string | non | Le template (nom ou identifiant) |
start_date | string | non | Le jour 0 du nouveau planning, avec from_template |
get_schedule
Lit un planning en entier : groupes, lignes, dates calculées, durées, avancement.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
name | string | non | |
notes | string | non | |
default_zoom | integer | non | |
propagation_mode | string (forward) | non | |
left_border_date | string | non | La date au bord gauche de la timeline |
left_panel_width | integer | non | En pixels |
Groupes
add_group
Ajoute un groupe — une phase du projet. Les lignes se rattachent à un groupe.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
label | string | oui | |
color | string | non | Couleur hexadécimale, sans dièse |
after | string | non | Identifiant du groupe après lequel insérer |
update_group
Change le libellé, la couleur ou le repliement d un groupe.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
group | string | oui | |
label | string | non | |
color | string | non | Couleur hexadécimale, sans dièse |
folded | boolean | non |
move_group
Déplace un groupe. Sans « after », il passe en tête.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
group | string | oui | |
after | string | null | non |
delete_group
Supprime un groupe et tout ce qu il porte : lignes, cellules, blocs, dépendances.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
group | string | oui |
Lignes
add_rows
Ajoute des lignes à un groupe, avec leurs cellules et leurs blocs. C est le tool de construction principal.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
group | string | oui | |
after | string | non | Identifiant de la ligne après laquelle insérer |
rows | object[] | oui |
move_rows
Déplace des lignes, éventuellement vers un autre groupe.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
rows | string[] | oui | |
group | string | oui | |
after | string | null | non |
indent_rows
Indente des lignes d un cran : elles deviennent filles de la ligne au-dessus.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
rows | string[] | oui |
outdent_rows
Désindente des lignes d un cran. Leurs descendantes remontent avec elles.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
rows | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
rows | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
fragment | object | oui | Le « fragment » rendu par copy_rows, tel quel |
group | string | oui | |
after | string | null | non | La 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
rows | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
type | string (text | symbol | trafficlight | startdate | enddate | duration | progress | status | autonumber) | oui | |
label | string | oui | |
width | integer | non | |
after | string | non |
delete_column
Supprime une colonne et ses cellules. La dernière colonne visible ne peut pas être supprimée.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
column | string | oui |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
row | string | oui | Identifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé » |
column | string | oui | |
value | string | oui |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
column | string | oui | |
label | string | non | |
type | string (text | symbol | trafficlight | startdate | enddate | duration | progress | status | autonumber) | non | |
width | integer | non | |
hidden | boolean | non | |
indent | boolean | non | Fait porter à cette colonne le décalage visuel de l indentation. Une seule à la fois. |
default_value | string | null | non |
move_column
Déplace une colonne. Sans « after », elle passe en première position.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
column | string | oui | |
after | string | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
column | string | oui | |
statuses | object[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
row | string | oui | Identifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé » |
column | string | oui | |
bold | boolean | non | |
italic | boolean | non | |
strike | boolean | non | |
text_color | string | null | non | |
background_color | string | null | non |
Timeline
update_timeline
Règle la timeline : granularité, jours ouvrés, plage horaire, en-têtes affichés.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
type | string (day | hour | minutes15 | minutes10 | minutes5) | non | |
active_days | boolean[] | non | Sept booléens, indice 0 = dimanche |
hide_weekend_days | boolean | non | |
first_week_day | 0 | 1 | 6 | non | |
active_hour_from | integer | non | |
active_hour_to | integer | non | |
mark_today | boolean | non | |
shade_days | boolean[] | non | Jours ombrés à l écran, indice 0 = dimanche. Sans effet sur les durées. |
weekend_shade_color | string | null | non | Couleur d ombrage, RRGGBBAA |
show_year | boolean | non | |
show_month | boolean | non | |
show_week_nr | boolean | non | |
show_date | boolean | non | |
show_week_day | boolean | non | |
time_format | string (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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
dates | object[] | oui | |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
dates | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
row | string | oui | Identifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé » |
start | string | oui | Date ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z |
duration | integer | oui | En unités de la timeline |
color | string | non | Couleur hexadécimale, sans dièse |
label | string | non | |
progress | integer | non | Avancement, 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
periods | string[] | oui | |
delta | integer | non | En unités ouvrées ; négatif pour avancer |
to | string | non | Date cible ; un seul bloc à la fois |
row | string | non | Nouvelle ligne ; un seul bloc à la fois |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
period | string | oui | |
duration | integer | oui | |
duration_unit | string (day | week | month | hour | minutes15 | minutes10 | minutes5) | non | L unité dans laquelle duration se compte ; celle du bloc si omise |
start | string | non | Date ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
periods | string[] | oui | |
color | string | non | Couleur hexadécimale, sans dièse |
label | string | non | |
progress | integer | null | non | null retire le suivi |
locked | boolean | non | true : 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
periods | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
row | string | oui | Identifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé » |
at | string | oui | Date ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z |
type | integer | integer | string | oui | Code 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 |
label | string | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
symbol | string | oui | Identifiant, 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 » |
to | string | non | Date cible |
delta | integer | non | En unités ouvrées ; négatif pour avancer |
row | string | non | Nouvelle ligne |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
symbols | string[] | oui | |
type | integer | integer | string | non | Code 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 |
label | string | non | |
locked | boolean | non | true : 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
symbols | string[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
search | string | non | « réunion », « meeting », « alerte »… |
schedule | string | non | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
from | string | oui | Identifiant, libellé d un bloc ou d une icône, ou « ligne @ date-ou-libellé » — avec l heure sur une timeline horaire |
to | string | oui | Identifiant, libellé d un bloc ou d une icône, ou « ligne @ date-ou-libellé » — avec l heure sur une timeline horaire |
type | string (fs | ss | ff | sf) | non | fs fin→début (défaut), ss début→début, ff fin→fin, sf début→fin |
lag | integer | non | Dé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 |
mode | string (hard | soft) | non | hard (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 |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
dependency | string | oui | Identifiant de la dépendance, ou « origine → cible » (deux références d éléments) |
type | string (fs | ss | ff | sf) | non | fs fin→début (défaut), ss début→début, ff fin→fin, sf début→fin |
lag | integer | non | Dé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 |
mode | string (hard | soft) | non | hard (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 |
propagate | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
dependency | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
target | object | object | object | oui | { period } | { symbol } | { row, column } |
body | string | oui |
delete_comment
Retire le commentaire d un bloc, d une icône ou d une cellule.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
target | object | object | object | oui | { 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
target | object | object | object | oui | { period } | { symbol } | { row, column } |
body | string | non | |
reply_id | string | non | La réponse à modifier ou à retirer |
delete | boolean | non | Avec 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
target | object | object | object | oui | { period } | { symbol } | { row, column } |
resolved | boolean | oui |
Légende
update_legend
Affiche ou masque la légende, et nomme les couleurs de blocs.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
display | boolean | non | |
periods | object[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
text | string | non | Texte cherché, sans accent ni casse |
colors | string[] | non | Couleurs de blocs |
symbols | integer[] | non | Types d icônes v23 |
backgrounds | string[] | non | Couleurs de fond de cellule |
lights | integer[] | non | Feux : 0 aucun, 1 rouge, 2 orange, 3 vert |
statuses | string[] | non | Statuts, par nom ou identifiant |
from | string | non | Début de la plage, inclus |
to | string | non | Fin 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
date | string | non | La date du trait |
visible | boolean | non | |
clear | boolean | non | Vrai 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
entries | object[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
period | string | non | Un bloc : libellé, identifiant, ou « ligne @ date » |
assignee | "me" | object | object | object | null | non | « me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer |
status | string (todo | doing | done) | non | todo (à 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
period | string | oui | Le bloc : libellé, identifiant, ou « ligne @ date » |
title | string | oui | |
context | string | non | Le contexte de l action, en Markdown léger |
assignee | "me" | object | object | object | null | non | « me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer |
status | string (todo | doing | done) | non | todo par défaut |
after | string | null | non | L 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
action | string | oui | Identifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc |
title | string | non | |
context | string | non | |
assignee | "me" | object | object | object | null | non | « me » (vous-même : votre jeton nommé, ou l utilisateur), { kind: "name", label } pour un nom, null pour retirer |
status | string (todo | doing | done) | non | todo (à faire), doing (en cours), done (fait) |
period | string | non | La 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 |
after | string | null | non | La 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
action | string | oui | Identifiant de l action, ou son titre — « Recette / relire » qualifie par le bloc |
status | string (todo | doing | done) | oui | todo (à 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
action | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
status | string (todo | doing | done) | non | todo (à faire), doing (en cours), done (fait) |
since | string | non | L 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
action | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | non | Un planning ; sans lui, vos alertes dans tous ceux que vous pouvez lire |
idle_days | integer | non | Jours 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
idle_days | integer | non | Jours 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | non | Un 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
motif | string (conges | temps_partiel | formation | autre) | oui | congés, temps_partiel, formation ou autre — jamais un motif médical |
forme | object | object | oui |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
absence | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
row | string | oui | Identifiant, numéro de ligne (1.2), libellé, ou « Groupe/Libellé » |
member | string | null | oui | « 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
trash | boolean | non | La corbeille plutôt que la liste |
templates | boolean | non | Les 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
restore_schedule
Rend à la liste un planning mis à la corbeille, tel qu il était.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
name | string | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
label | string | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
version | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
version | string | non | La 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
model | objet | oui | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
name | string | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
format | string (A4 | A3 | A2 | A1 | A0 | letter | legal | ledger) | non | |
orientation | string (landscape | portrait) | non | |
zoom_to_fit | boolean | non | |
range_start | string | null | non | |
range_end | string | null | non | |
include_legend | boolean | non | |
include_comments | boolean | non | |
show_critical_path | boolean | non | Le liseré du chemin critique à l impression et dans render_schedule (S9) |
show_baseline | boolean | non | Les 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
file | object | non | |
asset | string | non | L identifiant d un fichier déjà téléversé |
show | boolean | non | |
height | integer | non | La hauteur affichée, en pixels |
remove | boolean | non |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
asset | string | oui | L 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
period | string | oui | Le bloc, par libellé, « ligne @ date » ou identifiant |
at | string | oui | Date ISO, par exemple 2026-10-05 ou 2026-10-05T00:00:00.000Z |
label | string | non | |
kind | string | non |
update_marker
Renomme un marqueur, ou change son genre. Par son identifiant, ou par son libellé exact.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
marker | string | oui | Identifiant ou libellé du marqueur |
label | string | non | |
kind | string | non |
remove_marker
Retire un marqueur, par son identifiant ou son libellé exact ; undo le rend.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
marker | string | oui |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
email | string | oui | L e-mail de la personne |
role | string (editor | viewer) | oui | editor 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
email | string | non | Le membre à retirer |
invitation | string | non | L 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
password | string | non | Un mot de passe à demander ; absent, la page est ouverte |
allow_embed | boolean | non | Permettre l intégration en iframe (faux par défaut) |
show_absences | boolean | non | Montrer 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | |
start_date | string | oui | Premier jour du planning, YYYY-MM-DD. Sert de repère aux offsets. |
timeline | object | non | |
columns | object[] | non | Colonnes du panneau gauche. Par défaut : Activité, Responsable, Notes. |
holidays | object[] | non | Jours chômés — fériés, fermetures, absences (avec « rows ») |
groups | object[] | 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
commands | object[] | oui | |
dry_run | boolean | non | |
expected_rank | integer | non | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
delta | integer | oui | En 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
format | string (v23 | palmaplan | csv | ics | msproject_xml) | oui | |
content | string | oui | Le contenu du fichier, tel quel |
name | string | non | Le nom du planning ; sinon une donnée projet du fichier, sinon « Planning importé » |
mapping | object | non | CSV seulement : quelle en-tête porte quoi |
timeline | string (day | hour) | non | ICS 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
format | string (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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
format | string (svg | png | pdf) | oui | |
range | object | non | La plage montrée, AAAA-MM-JJ ; sinon toute la période du planning |
zoom | integer | non | Le 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_legend | boolean | non | Le bandeau de légende ; par défaut, le réglage du planning |
include_comments | boolean | non | L annexe des commentaires, numérotés comme les repères du dessin |
include_actions | boolean | non | L annexe des actions : par bloc, cochées, avec leur responsable (S10) |
critical_path | boolean | non | Le 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) |
baseline | boolean | non | Les 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. |
width | integer | non | La largeur en pixels, 1 200 par défaut |
scale | number | non | PNG seulement : le facteur de définition, 2 pour un rendu Retina |
paper | object | non | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
today | string | non | La date du rapport, YYYY-MM-DD ; sinon maintenant |
horizon_days | integer | non | Les 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
action | object | object | object | oui |
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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
from_seq | integer | non | Le rang de départ, tel que get_history le rend |
to_seq | integer | non | Le rang d arrivée ; sinon le courant |
from_version | string | non | La version de départ (S8) ; « baseline » : la référence (S9) |
to_version | string | non | La 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
actor | string (user | mcp) | non | |
since_seq | integer | non | Les entrées de rang strictement supérieur |
from | string | non | Les entrées à partir de cette date |
to | string | non | Les entrées jusqu à cette date, exclue |
types | string[] | non | Les types de commande retenus, par exemple ["period.move"] |
limit | integer | non | Les 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
element | string | non | Un 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
filter | string | non | Un filtre, dans la syntaxe de l écran : t:texte, c:couleurs, s:statuts, d:début, f:fin, séparés par ; |
zoom | integer | non | Le cran de zoom (code v23 : 8 = semaine, 9 = jour, 10 = jour large…) |
from | string | non | Le premier jour visible (AAAA-MM-JJ) |
to | string | non | Le dernier jour visible (AAAA-MM-JJ) : avec from, la vue cadre cette fenêtre |
panel | string (grid | timeline | both) | non | La grille seule, le ruban seul, ou les deux (défaut) |
critical_path | boolean | non | Peindre le chemin critique |
reference | boolean | non | Montrer la version de référence (les ombres), si le planning en a une |
editable | boolean | non | Faux : 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 |
view | string (gantt | kanban | agenda) | non | Ce 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
cursor | string | non | Le next_cursor de la page précédente ; absent, la première page |
version | string | non | Une 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
since | integer | oui | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
steps | integer | non | Le 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ètre | Type | Obligatoire | Description |
|---|---|---|---|
schedule | string | oui | Identifiant du planning, ou son nom — « Migration S/4HANA » convient |
steps | integer | non | Le nombre de lots ; 1 par défaut |
Resources (10)
Resources concrètes (5)
| Nom | Adresse | Type MIME | Description |
|---|---|---|---|
schedules | palmaplan://schedules | text/markdown | Liste des plannings connus |
templates | palmaplan://templates | text/markdown | Les plannings enregistrés comme templates, à instancier par create_schedule { from_template, start_date } |
symbols | palmaplan://symbols | text/markdown | Les 91 codes d icônes du format v23, avec leurs noms et mots-clés |
me-actions | palmaplan://me/actions | text/markdown | Les actions qui me sont confiées, tous plannings confondus, regroupées par planning (S23) |
schedule-app | ui://palmaplan/planning | text/html;profile=mcp-app | La 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)
| Nom | Modèle d’adresse | Type MIME | Description |
|---|---|---|---|
schedule | palmaplan://schedule/{id} | text/markdown | Vue lisible complète d un planning : groupes, lignes, dates, durées |
schedule-json | palmaplan://schedule/{id}/json | application/json | Modèle complet normalisé, pour les traitements exacts |
schedule-history | palmaplan://schedule/{id}/history | text/markdown | Journal des commandes appliquées : qui, quoi, quand |
schedule-dependencies | palmaplan://schedule/{id}/dependencies | text/markdown | Le graphe des dépendances d un planning : la liste, avec les liens violés marqués, et un diagramme Mermaid |
schedule-actions | palmaplan://schedule/{id}/actions | text/markdown | Les 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.
| Argument | Obligatoire | Description |
|---|---|---|
description | oui | Le projet à planifier, en texte libre. Plus c'est précis, mieux c'est. |
start_date | non | Date de début, YYYY-MM-DD |
end_date | non | Échéance à tenir, si elle est imposée |
granularity | non | « 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.
| Argument | Obligatoire | Description |
|---|---|---|
content | oui | Le texte à interpréter |
schedule | non | Planning à 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.
| Argument | Obligatoire | Description |
|---|---|---|
schedule | oui | Le planning : identifiant ou nom |
constraint | oui | La 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.
| Argument | Obligatoire | Description |
|---|---|---|
schedule | oui | Le planning : identifiant ou nom |
period | oui | Le 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.
| Argument | Obligatoire | Description |
|---|---|---|
schedule | oui | Le planning : identifiant ou nom |
today | non | La date du point, YYYY-MM-DD ; sinon aujourd'hui |