Piloter Notion avec Claude sans ouvrir l'app

1. Ce que Claude fait dans Notion

Notion est un outil puissant, mais son interface est un goulot d'étranglement : six clics pour créer une base, vingt cycles de saisie pour vingt entrées, encore des clics pour filtrer et exporter. Ce skill est né d'un constat simple : structurer, ranger et retrouver peut occuper 20 % du temps passé dans l'outil. Le vrai problème de Notion n'est pas Notion, c'est le clic.

Une fois le serveur MCP branché, Claude prend le relais dans cinq rôles complémentaires. Tu décris ce que tu veux en français, il l'exécute dans ton espace, et tu gardes la main sur ce qu'il touche.

Tout passe par le langage naturel, sans apprendre le langage technique de l'outil ni écrire une ligne de code. Trois profils en tirent un bénéfice immédiat : les indépendants qui tiennent leur suivi commercial et leurs projets dans Notion, les petites équipes qui veulent des bases propres sans former tout le monde, et les habitués de Zapier ou Make qui cherchent une voie plus directe pour les opérations Notion.

2. Brancher le serveur MCP Notion

Le MCP, pour Model Context Protocol, est le standard qui permet à Claude de parler directement à un outil externe. Notion publie un serveur MCP officiel, et il existe deux façons de le brancher à Claude Code. Procédure vérifiée le 30/08/2026.

2.1 Le serveur hébergé, la voie recommandée

Notion héberge désormais son propre serveur MCP et concentre dessus tout son support. Une seule commande l'ajoute à Claude Code :

claude mcp add --transport http notion https://mcp.notion.com/mcp

Tape ensuite /mcp dans Claude Code, sélectionne notion et suis la connexion OAuth dans ton navigateur. Claude hérite alors des accès de ton compte Notion : il voit ce que tu vois, rien de plus.

2.2 L'intégration interne, pour restreindre l'accès

L'autre voie passe par un jeton d'intégration. Elle demande plus de manipulations, mais elle te laisse limiter Claude à quelques pages choisies plutôt qu'à tout ton compte.

1. Crée une intégration de type Internal sur la page notion.so/profile/integrations.
2. Copie le secret d'intégration, qui commence par ntn_.
3. Ajoute le serveur local à Claude Code :

claude mcp add notion --env NOTION_TOKEN=ntn_TON_JETON -- npx -y @notionhq/notion-mcp-server

1. Connecte chaque page parente à l'intégration : menu « ... » de la page, puis Connexions, puis le nom de ton intégration. Les sous-pages héritent automatiquement de l'accès.

Pour vérifier, relance Claude Code et tape « liste mes pages Notion récentes ». Une vraie liste confirme que tout fonctionne. Une erreur de permission signifie presque toujours qu'une page n'est pas connectée à l'intégration.

3. Installer le skill co-pilote

Un skill est un dossier d'instructions que Claude charge tout seul quand ta demande touche son domaine ; le mécanisme est détaillé dans le guide des Skills Claude. Le serveur MCP donne les outils, le skill donne la méthode : sans lui, Claude écrit dans Notion sans filet ni réflexes.

3.1 Récupérer le fichier prêt à installer

Le skill complet, avec ses références et ses trois exemples, se télécharge sur le site personnel de Melvin, contre la même adresse email que celle utilisée ici.

Télécharger le fichier prêt à installer

3.2 Le placer dans le dossier des skills

unzip notion-claude-co-pilot.zip -d ~/.claude/skills/

Si le dossier ~/.claude/skills/ n'existe pas encore, crée-le d'abord. Au prochain démarrage de Claude Code, le skill se déclenche dès qu'une demande concerne Notion. Procédure vérifiée le 30/08/2026.

3.3 Ce que contient l'archive

Le cœur du fichier SKILL.md tient en cinq règles, que Claude applique à chaque session :

1. Comprendre l'intention avant d'agir, avec une question au maximum en cas d'ambiguïté.
2. Toujours lire le schéma d'une base existante avant d'y écrire quoi que ce soit.
3. Écrire d'abord, puis vérifier par une requête de contrôle que la donnée est bien là.
4. Grouper les opérations dès qu'il y a plus de 3 entrées à toucher.
5. Confirmer chaque opération en une ligne, du type « 12 entrées créées ».

La valeur d'un skill bien fait ne tient pas au code, il n'y en a aucun ici. Elle tient à la précision avec laquelle il décrit le comportement attendu de Claude.

4. Les cinq prompts essentiels

D'expérience, ces cinq gabarits couvrent 90 % des besoins courants sur Notion. Remplace les noms par les tiens, colle, et laisse Claude exécuter.

Créer une base

Crée une base Notion "Clients" sous la page "Mon suivi commercial" avec :

- Nom : titre
- Email : email
- Statut : select (Prospect, Devis envoyé, Signé, Perdu, Fidèle)
- Date premier contact : date
- Montant : number format euro
- Notes : texte

Renvoie-moi l'ID de la data source créée.

Remplir en série

Dans la base "Clients", ajoute ces 12 entrées :

1. Marie Dupont | marie@dupont.fr | Signé | 2026-01-15 | 1500
2. Pierre Martin | pierre.martin@mail.com | Prospect | 2026-04-20 | 0
3. ...

Si la base n'existe pas encore, crée-la avant.
Procède en un seul appel groupé.

Tu peux aussi coller un CSV, un export de tableur ou la photo d'un tableau papier : Claude lit, structure et insère.

Filtrer et chercher

Dans la base "Clients", sors-moi toutes les entrées Statut = "Prospect"
sans relance depuis plus de 7 jours, triées par date de premier contact.
Renvoie un tableau avec : Nom, Email, Date premier contact, Notes.

Relier deux bases

Crée une relation DUAL entre "Projets" et "Tâches" :

- sur Projets : "Tâches", la collection des tâches du projet
- sur Tâches : "Projet", le projet auquel la tâche appartient

Une relation DUAL se voit des deux côtés, et c'est presque toujours ce que tu veux.

Corriger en masse

Dans la base "Clients", pour toutes les entrées Statut = "Prospect"
et sans relance depuis plus de 14 jours :
Update Statut = "Perdu".
Confirme le nombre d'entrées modifiées à la fin.

Les cinq se combinent en une seule demande. Tu peux créer une base, la remplir avec 50 contacts collés, filtrer par pays et exporter le résultat en CSV, sans reformuler entre les étapes.

5. Trois exemples de bout en bout

Les trois fichiers d'exemples du skill sont écrits comme des sessions réelles, à copier et rejouer. Voici ce qu'ils construisent.

Un suivi commercial léger

Une base Clients à neuf propriétés : identité, coordonnées, un statut en cinq états de Prospect à Fidèle, le type de mission, deux dates et le montant. Un premier prompt la crée, un deuxième la remplit avec ton historique en un seul appel groupé. La routine tient ensuite en deux demandes hebdomadaires : sortir les prospects sans relance depuis 7 jours, puis passer en Perdu ceux qui dorment depuis 14 jours. Une seconde base Interactions, reliée en DUAL, donne à chaque client son historique d'échanges.

Un tableau de suivi multi-projets

Deux bases reliées : Projets, avec statut, priorité, échéances, budget et avancement, et Tâches, avec échéance, heures estimées et heures réelles. Le lundi matin, un seul prompt recalcule l'avancement de chaque projet à partir des tâches terminées. Détail utile de l'exemple : quand toutes les tâches sont finies mais que le projet reste marqué En cours, Claude prévient au lieu de modifier en silence.

Un calendrier de publication

Une base Calendrier édito : canal, un statut en six états de Idée à Archivé, type de contenu, date, lien et performance. Le dimanche, un prompt sort la semaine à venir et les idées restées sans date. Une fois par mois, un bilan compte les publications par canal et repère les sujets des contenus qui ont le mieux marché. Ce genre de rendez-vous récurrent peut d'ailleurs tourner tout seul, et c'est exactement le terrain du guide des routines Claude.

6. Les douze pièges les plus fréquents

Le fichier references/03-patterns-erreurs.md du skill les documente un par un. Les voici en version courte, relevés sur l'API Notion le 30/08/2026.

7. Ce que Claude ne doit pas toucher

Donner la main sur ton espace de travail impose quelques garde-fous, et le skill en installe une partie.

• Les suppressions et archivages de masse exigent une confirmation explicite avant exécution, la règle est écrite dans le SKILL.md.
• Renommer une propriété qui contient déjà des valeurs déclenche un avertissement plutôt qu'une action directe.
• Le serveur MCP ne peut ni créer un espace de travail, ni modifier les permissions, ni lire ce qui ne lui est pas partagé. Ces gestes restent dans l'interface Notion, et c'est une bonne chose.

Ajoute une précaution de bon sens : avec la connexion OAuth, Claude hérite de tous tes droits. Pour tes premiers essais, travaille sur une page de test, ou choisis la voie du jeton et ne connecte que les pages utiles. Les pages supprimées passent par la corbeille de Notion, rien ne disparaît sans rattrapage possible, mais un grand nettoyage involontaire reste long à défaire.

8. Quand Notion ne suffit plus

Ce montage rend Notion nettement plus productif, mais il ne repousse pas ses limites structurelles. Nous les connaissons de l'intérieur : nous avons nous-mêmes sorti notre suivi commercial de Notion pour le poser sur une vraie base de données, le jour où le volume et les croisements ont dépassé ce que l'outil fait bien.

Trois signaux indiquent que tu approches du même point :

• Les volumes : des milliers de lignes à parcourir par blocs de 100, des exports qui rament, des vues qui mettent plusieurs secondes à s'afficher.
• Les croisements : des calculs entre bases qui demandent des acrobaties de formules, là où une simple requête ferait le travail.
• Les processus critiques : une relance client ou une facturation qui repose sur la discipline de saisie de chacun, sans contrôle possible.

Avant de tout migrer, vérifie que le problème vient bien de l'outil et pas de l'usage : c'est plus rare qu'on ne le croit, comme le montre pourquoi votre CRM est sous-utilisé. Si tes données vivent éparpillées entre Notion, un tableur et la boîte mail, commence par les centraliser sans tout casser. Et quand la limite est réellement structurelle, un outil construit pour ton métier prend le relais, avec tes règles et tes volumes : c'est le terrain de nos solutions sur mesure.

Questions fréquentes

Le serveur MCP Notion est-il payant

Non. Le serveur hébergé est fourni par Notion sans surcoût, et un compte Notion gratuit suffit pour l'utiliser. Côté Claude, chaque opération consomme ton quota d'abonnement comme un message normal, ni plus ni moins.

Claude peut-il abîmer mes bases Notion

Il écrit avec tes droits, donc le risque existe. Le skill impose une confirmation avant toute suppression de masse et un avertissement avant les renommages sensibles. Pour tes premiers essais, travaille sur une page de test, et garde en tête que les pages supprimées restent dans la corbeille de Notion.

Quelle différence entre le serveur hébergé et l'intégration interne

Le serveur hébergé se branche en une commande, s'authentifie par OAuth et hérite de tous tes accès, et c'est lui que Notion maintient activement. L'intégration interne demande un jeton et une connexion page par page, mais elle limite Claude aux seules pages choisies. Commence par le serveur hébergé, passe au jeton si tu veux restreindre.

Le skill fonctionne-t-il ailleurs que dans Claude Code

Le serveur MCP Notion se branche aussi sur Claude Desktop et sur les autres clients compatibles MCP. Le dossier de skill, lui, est au format de Claude Code. Ailleurs, tu peux coller le contenu du SKILL.md dans les instructions d'un projet, le comportement décrit reste le même.