← Retour à la liste←
★★★★☆ 4 / 5
Catégorie 05 — MCP

MCP Notion

Intégration Notion complète — pages, bases de données, blocs via IA

Installation
Prérequis — créer l'integration Notion# 1. Aller sur https://www.notion.com/my-integrations # 2. Cliquer "+ New integration" # 3. Nommer l'integration (ex: "Claude Code MCP") # 4. Choisir votre workspace # 5. Capabilities : Read content, Update content, Insert content # 6. Copier le token "ntn_xxxxxxxxxxxx" # 7. IMPORTANT : dans chaque page Notion à partager : # → cliquer "..." → Connections → ajouter votre integration
Claude Code (via npm)claude mcp add notion \ -e NOTION_API_KEY=ntn_votre_token \ -- npx -y @notionhq/notion-mcp-server
Configuration manuelle (.mcp.json)# .mcp.json à la racine du projet cat > .mcp.json << 'EOF' { "mcpServers": { "notion": { "command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": { "NOTION_API_KEY": "ntn_votre_token" } } } } EOF
Versionv1.x (mai 2026)
PrixGratuit (inclus avec Notion — Free → Plus 10 $/mois)
Plateformes
WindowsmacOSLinux
Commandes7
Exemples3
MCP
À propos

Serveur MCP officiel Notion permettant à Claude Code, Cursor et tout agent IA compatible de lire, créer et mettre à jour des pages Notion, interroger des bases de données, et gérer les blocs de contenu. Utile pour synchroniser la documentation projet, les backlogs, les specs techniques et les wikis d'équipe avec le contexte IA. Requiert une Integration interne Notion (token `ntn_xxx`).

Fonctionnalités clés
Lecture et recherche de pagesRécupérez n'importe quelle page Notion par son ID ou cherchez par texte dans tout le workspace. L'IA peut retrouver une spec technique, un compte-rendu de réunion ou une documentation API sans que vous ayez à copier-coller.
Interrogation de bases de données (Query)Filtrez, triez et paginez des bases de données Notion — backlogs, sprints, roadmaps. "Montre-moi toutes les user stories du sprint actuel avec le statut TODO" → résultat direct dans le contexte IA.
Création et mise à jour de pagesCréez des pages structurées (avec propriétés, tags, dates) directement depuis le chat IA. Documentez automatiquement une feature implémentée, créez un ticket de bug ou mettez à jour le statut d'une tâche.
Gestion des blocs de contenuAjoutez du contenu à une page existante — paragraphes, listes, code blocks, callouts. Idéal pour enrichir progressivement une documentation technique à partir des échanges IA.
Navigation dans la hiérarchie NotionExplorez la structure de votre workspace — liste des pages enfants, navigation dans les bases de données imbriquées. L'IA comprend l'organisation de votre Notion sans que vous ayez à expliquer la structure.
Commandes
CommandeDescription
notion_retrieve_pageRécupérer une page Notion par son ID (UUID)
notion_searchRechercher des pages ou des bases de données par texte dans le workspace
notion_query_databaseInterroger une base de données avec filtres (propriétés, statut, dates)
notion_create_pageCréer une nouvelle page dans une base de données ou en page enfant
notion_update_pageMettre à jour les propriétés d'une page existante (statut, titre, tags)
notion_append_block_childrenAjouter des blocs de contenu (paragraphes, listes, code) à une page
notion_retrieve_block_childrenLister les blocs de contenu d'une page (lecture récursive)
Exemples
Lire une spec technique avant de coderCODE
// Dans Claude Code, avec le MCP Notion actif :
"Cherche dans Notion la spec technique pour le module
'user_profile' de notre projet Drupal. Lis la page
et résume les endpoints REST à implémenter,
les champs requis et les contraintes de validation."
// Claude search → retrieve → résumé actionnable
Documenter une feature implémentéeCODE
// Après avoir codé une feature :
"Dans notre base de données Notion 'Documentation Modules'
(ID: abc123-....), crée une nouvelle page pour le module
'node_revision_cleaner' avec :
- Titre: Node Revision Cleaner
- Statut: ✅ Implémenté
- Version: Drupal 11
- Description: [génère depuis le code que tu viens d'écrire]
- Exemples d'usage: [avec les commandes drush associées]"
Interroger le backlog sprintCODE
// Récupérer les tâches du sprint en cours :
"Interroge la base de données Notion 'Sprint Board'
(ID: def456-....). Filtre les entrées où :
- Sprint = 'Sprint 42'
- Status = 'In Progress' ou 'TODO'
Trie par priorité décroissante et liste-les avec
l'assigné et la date d'échéance."
Points forts & faibles
Points forts
+Officiel Notion — maintenu par l'équipe core
+Lecture et écriture complètes — pas seulement du read-only
+Synchronisation documentation ↔ code IA sans copier-coller
+Interrogation de bases de données avec filtres et tri
+Gratuit — inclus dans tous les plans Notion
+Simple à configurer (un seul token à créer)
Points faibles
−Token à créer manuellement dans les settings Notion (5 min)
−Accès limité aux pages explicitement partagées avec l'integration
−Pas de support des commentaires Notion (lecture/écriture)
−Pas de gestion des médias/fichiers uploadés
−L'API Notion a une limite de débit (3 req/s) — peut ralentir sur de grands workspaces
−Pas de support des synced blocks
Verdict

Excellent pour les équipes qui utilisent Notion comme source de vérité documentaire. Permet de demander à Claude de se documenter automatiquement ou de lire les specs avant de coder. Le setup est simple et le serveur est fiable. Incontournable si Notion est votre wiki équipe.

→ Équipes utilisant Notion pour la documentation, les backlogs ou les wikis projet. Particulièrement utile pour les projets Drupal où la doc technique (hooks, modules, API) est dans Notion.