Pour développeurs et agents

Développe sur le Plannie de ta famille.

Connecte Claude - ou n’importe quel agent - à ton foyer via MCP, ou développe sur l’API REST ouverte. Une clé à portée limitée, une config collé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 - pas une intégration ajoutée après coup.

Crée une clé

Dans Plannie, ouvre Réglages → Intégrations et crée une clé API. Choisis exactement les portées que ton agent doit avoir - calendrier seulement, listes seulement, ce qui te convient.

Pointe ton agent dessus

Colle une petite config dans ton client MCP, ou appelle directement l’API REST. Pas de SDK, pas de danse OAuth - la clé, c’est toute la poignée de main.

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.

CONNEXION

Choisis ton outil

Une commande ou un clic pour les agents les plus courants - tous parlent au même serveur MCP hébergé. L’API REST est là si tu préfères construire toi-même.

Reste ici même, dans ton navigateur - elle sert uniquement à remplir les extraits et boutons 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 que Plannie soit disponible dans tous les projets, puis vérifie avec /mcp.

{
  "mcpServers": {
    "plannie": {
      "command": "npx",
      "args": ["-y", "@plannie/mcp"],
      "env": {
        "PLANNIE_API_URL": "https://api.plannie.io/v1",
        "PLANNIE_API_KEY": "fam_live_…"
      }
    }
  }
}

Colle dans claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit config). npx télécharge @plannie/mcp au premier lancement - aucune installation à faire.

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

Ajouter à Cursorou colle dans ~/.cursor/mcp.json - global, ou par projet dans .cursor/mcp.json.

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

Installer dans VS Codeou exécute la commande ci-dessus, ou ajoute le serveur à .vscode/mcp.json.

codex mcp add plannie \
  --env PLANNIE_API_URL=https://api.plannie.io/v1 \
  --env PLANNIE_API_KEY=fam_live_… \
  -- npx -y @plannie/mcp

Enregistre le pont local @plannie/mcp auprès de Codex CLI - ça atterrit dans ~/.codex/config.toml.

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, ou tu veux les détails ? La référence API a le guide complet par client sous « Connect an agent ».

OUTILS

Ce que ton agent peut faire

Seize outils couvrent la semaine de la famille - événements, tâches, listes, repas, 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_activity

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. Un tableau de bord d’entrée obtient calendar.read et rien d’autre ; révoque n’importe quelle clé à tout moment depuis Réglages → Intégrations.

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

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, généré depuis l’API en production, et suffisant pour se connecter sans humain dans la boucle - sauf la clé, qu’un membre du foyer crée pour toi.

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 · clé Bearer fam_live_…
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 - tout client MCP ou appel REST peut se connecter avec une clé API à portée limitée qu’un membre du foyer crée dans Réglages → Intégrations. Les portées sont accordées par clé (calendrier seulement, listes seulement, ce dont l’agent a besoin) et peuvent expirer à une date choisie.

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 - servi en direct par l’API elle-même, toujours synchronisé avec ce qui est déployé.

Ouvrir la référence API

L’accès API et MCP fait partie du forfait Premium + MCP - et inclus dans tout essai.