Pour développeurs et agents

Développe sur le Plannie de ta famille.

Connecte ChatGPT, Claude ou n’importe quel agent à ton foyer via MCP, ou développe sur l’API REST ouverte. Connecte-toi avec OAuth ou utilise une clé à portée limitée. Environ dix minutes.

Plannie est un organisateur familial partagé avec une interface agent de première classe : un serveur MCP hébergé et une API REST ouverte, à portée limitée par foyer, attribuée par nom et révocable à tout moment. Ça fait partie du produit, pas un ajout après coup.

1

Ajoute l’adresse

Tous les assistants et clients MCP parlent au même serveur hébergé : https://api.plannie.io/mcp. Ajoute-le comme connecteur personnalisé ou serveur MCP distant.

2

Connecte-toi, ou prends une clé

Deux façons d’entrer, avec les mêmes portées dans les deux cas.

Connexion avec OAuth Pour ChatGPT, Claude, Meta Muse et d’autres assistants. Tu te connectes à Plannie et tu choisis ce que l’assistant peut voir et modifier. Pas besoin de clé.
Clé API Pour Claude Code, Cursor, VS Code, Codex et les scripts. Crée une clé dans Réglages → Intégrations et envoie-la en Authorization: Bearer fam_live_….

3

Regarde-le apparaître

Tout ce qu’un agent ajoute apparaît dans le calendrier familial avec un badge scintillant et une entrée dans le fil d’activité, attribuée par nom. Tout le foyer voit ce qui a été fait, et par qui.

ASSISTANTS

Connecte-toi depuis ChatGPT, Claude ou Meta Muse

Ajoute Plannie dans ton assistant, connecte-toi à Plannie et choisis ce qu’il peut voir et modifier. La plupart des assistants n’ont pas besoin de clé. Tout ce qu’il ajoute apparaît pour toute la famille, marqué à son nom.

Claude

Touche Ajouter à Claude, ou ouvre « Customize », puis « Connectors » et « Add custom connector », et colle l’adresse ci-dessous.
Vérifie le nom et l’adresse, puis ajoute-le. Les réglages de connexion recommandés conviennent.
Connecte-toi à Plannie et choisis « Allow ».

Fonctionne sur claude.ai et dans Claude Desktop, puis aussi dans l’appli Claude sur mobile. Le forfait Free permet un connecteur personnalisé. Sur Team et Enterprise, un propriétaire l’ajoute d’abord dans « Organization settings ».

Ajouter à Claude

Adresse MCP de Plannie https://api.plannie.io/mcp

ChatGPT

Ouvre chatgpt.com/plugins, touche + et choisis « Add custom MCP server ».
Nomme-le Plannie, colle l’adresse ci-dessous comme « Server URL » et choisis OAuth.
Crée le plugin, installe-le et connecte-toi à Plannie. Ensuite, tape @Plannie dans une discussion.

OpenAI prend en charge les serveurs MCP personnalisés sur ChatGPT Business, Enterprise et Edu, sur le web, et un admin devra peut-être l’ajouter. Sur Pro, c’est en lecture seule : ChatGPT peut lire ta semaine, mais pas la modifier. Les clés API ne marchent pas dans ChatGPT.

Adresse MCP de Plannie https://api.plannie.io/mcp

Meta Muse

Demande à Muse de créer un connecteur personnalisé pour le serveur MCP de Plannie à l’adresse ci-dessous.
Connecte-toi à Plannie quand Muse te le demande. S’il veut plutôt une clé, crée-en une dans Réglages → Intégrations et saisis-la dans le champ sécurisé, jamais dans la discussion.
Demande à Muse de lister les outils de Plannie pour vérifier que ça marche.

Muse n’est disponible qu’aux États-Unis et au Canada.

Adresse MCP de Plannie https://api.plannie.io/mcp

Mistral Vibe

Ouvre « Connectors », choisis « Add Connector », puis l’onglet « Custom MCP Connector ».
Nomme-le plannie et colle l’adresse ci-dessous comme « Server URL ».
Choisis « Connect » et connecte-toi à Plannie.

Anciennement Le Chat. Sur Team et Enterprise, c’est un admin qui ajoute le connecteur.

Adresse MCP de Plannie https://api.plannie.io/mcp

Perplexity

Ouvre « Plugins » (ou « Customize », puis « Connectors ») et choisis « Add custom », puis « Add MCP connector » et « Remote ».
Nomme-le Plannie, colle l’adresse ci-dessous et choisis OAuth sous « Advanced ».
Ajoute-le, puis clique sur la carte pour te connecter à Plannie.

Les connecteurs personnalisés demandent Perplexity Pro, Max ou Enterprise.

Adresse MCP de Plannie https://api.plannie.io/mcp

Autres clients MCP

Cherche dans ses réglages connecteur personnalisé (custom connector), serveur MCP distant ou streamable HTTP.
Colle l’adresse ci-dessous.
Connecte-toi à Plannie, ou envoie une clé API en en-tête Authorization: Bearer s’il en demande une.

Adresse MCP de Plannie https://api.plannie.io/mcp

Seul un adulte de la famille peut connecter un assistant, et il faut le forfait Premium + MCP. Déconnecte-le quand tu veux dans Réglages → Intégrations → Assistants connectés. Tu utilises Claude Code, Cursor, VS Code ou Codex ? Choisis ton outil ci-dessous.

OUTILS DE CODE

Utilise une clé API

Pour Claude Code, Cursor, VS Code, Codex, LM Studio et tes propres scripts. Crée une clé dans Plannie sous Réglages → Intégrations, choisis ses portées et colle-la ci-dessous pour remplir chaque extrait. Claude Code, Cursor, VS Code et Codex peuvent aussi se connecter avec OAuth.

Reste ici même, dans ton navigateur. Elle sert uniquement à remplir les extraits ci-dessous.

claude mcp add --transport http plannie https://api.plannie.io/mcp \
  --header "Authorization: Bearer fam_live_…"

Une commande dans ton terminal. Ajoute --scope user pour utiliser Plannie dans tous tes projets. Pour te connecter avec OAuth, enlève la partie --header et lance /mcp.

{
  "mcpServers": {
    "plannie": {
      "url": "https://api.plannie.io/mcp",
      "headers": { "Authorization": "Bearer fam_live_…" }
    }
  }
}

Ajouter à Cursor (s’ouvre dans un nouvel onglet)Le bouton ajoute Plannie et Cursor te connecte avec OAuth. Pour utiliser une clé, colle l’extrait dans ~/.cursor/mcp.json.

code --add-mcp '{"name":"plannie","type":"http","url":"https://api.plannie.io/mcp","headers":{"Authorization":"Bearer fam_live_…"}}'

Ajouter à VS Code (s’ouvre dans un nouvel onglet)Le bouton ajoute Plannie et VS Code te connecte avec OAuth. Pour utiliser une clé, lance la commande ci-dessus ou ajoute-le à .vscode/mcp.json.

export PLANNIE_API_KEY=fam_live_…
codex mcp add plannie --url https://api.plannie.io/mcp \
  --bearer-token-env-var PLANNIE_API_KEY

Codex lit la clé dans PLANNIE_API_KEY. Enlève --bearer-token-env-var et Codex te connecte avec OAuth à la place. La config atterrit dans ~/.codex/config.toml.

{
  "mcpServers": {
    "plannie": {
      "url": "https://api.plannie.io/mcp",
      "headers": { "Authorization": "Bearer fam_live_…" }
    }
  }
}

Ajouter à LM Studio (s’ouvre dans un nouvel onglet)LM Studio a besoin de la clé. Une fois Plannie ajouté par le bouton, mets l’en-tête Authorization de l’extrait dans mcp.json (Program → Install → Edit mcp.json).

curl "https://api.plannie.io/v1/events?from=2026-08-24&to=2026-08-30" \
  -H "Authorization: Bearer fam_live_…"

Du REST tout simple sous /v1 : du JSON en entrée, du JSON en sortie, à la portée de ta clé. Le contrat complet vit dans la référence API en direct.

Un autre client ? Tout ce qui parle MCP à distance marche : ajoute l’adresse, puis connecte-toi ou envoie la clé en en-tête Bearer. Chaque endpoint est dans la référence API.

OUTILS

Ce que ton agent peut faire

Vingt-sept outils couvrent la semaine de la famille : événements, tâches, listes, repas, fichiers, membres et le fil d’activité. Chacun correspond directement à l’API REST, donc ce que MCP peut faire, ton propre code peut le faire aussi.

list_eventscreate_eventupdate_eventdelete_eventlist_taskscreate_taskcomplete_taskget_listsadd_list_itemcheck_list_itemget_meal_planset_mealremove_meallist_recipesget_membersget_activitylist_folderslist_filessearch_filesget_fileget_file_urlupload_filemove_fileupdate_file_detailsrename_filedelete_filecreate_folder

PORTÉES

Des clés qui n’ouvrent qu’une seule porte

Chaque clé est limitée à sa création et peut expirer à une date de ton choix. Avec OAuth, tu choisis les mêmes portées sur l’écran de consentement de Plannie. Un tableau de bord d’entrée obtient calendar.read et rien d’autre ; retire l’accès à tout moment depuis Réglages → Intégrations.

calendar.readcalendar.writetasks.readtasks.writelists.readlists.writemeals.readmeals.writechores.readcheckins.readcheckins.writeactivity.readfiles

POUR LES AGENTS

Auto-descriptif, volontairement

Si tu es un agent en train de lire ceci : tout ce qui suit est lisible par une machine et généré depuis l’API en production. Pour te connecter, ajoute l’adresse MCP dans un client compatible OAuth et laisse la personne se connecter, ou demande-lui une clé API depuis Réglages → Intégrations. Tu ne peux pas terminer la connexion à sa place.

Spécification OpenAPI https://api.plannie.io/openapi.json chaque endpoint, schéma et erreur, généré depuis l’API en production
Référence API https://api.plannie.io/docs la même spécification, consultable par des humains
MCP hébergé https://api.plannie.io/mcp HTTP en streaming · OAuth 2.1 ou clé Bearer fam_live_…
Métadonnées OAuth https://api.plannie.io/.well-known/oauth-protected-resource/mcp les métadonnées que les clients MCP utilisent pour lancer la connexion
llms.txt https://plannie.io/llms.txt cette page, condensée pour les agents

Questions développeurs et agents

Les agents IA peuvent-ils se connecter à Plannie, et avec quelles portées ?+

Oui, de deux façons. ChatGPT, Claude et d’autres assistants se connectent avec OAuth : tu ajoutes l’adresse MCP de Plannie, tu te connectes et tu choisis ce que l’assistant peut voir et modifier. Les outils de code et les scripts peuvent utiliser une clé API à portée limitée qu’un membre du foyer crée dans Réglages → Intégrations. Dans les deux cas, l’accès se limite aux portées choisies, et les clés peuvent expirer à une date de ton choix.

Quel forfait inclut l’accès à l’API et à MCP ?+

Le forfait Premium + MCP (voir les tarifs pour le prix actuel). Il inclut tout ce qu’il y a dans Plannie Premium, plus l’API ouverte et le serveur MCP hébergé pour tes propres agents, automatisations et intégrations.

L’activité des agents est-elle visible par la famille ?+

Toujours. Chaque événement, tâche ou élément de liste créé par un agent porte un badge scintillant dans l’app et une entrée nommée dans le fil d’activité du foyer. Rien de ce que fait un agent n’est invisible aux personnes qui partagent le foyer.

La référence complète

Chaque endpoint, chaque forme de requête et chaque code d’erreur, servis en direct par l’API elle-même et toujours synchronisés avec ce qui est déployé.

Ouvrir la référence API

L’accès API et MCP fait partie du forfait Premium + MCP.