Notion MCP

Vue d'ensemble

Notion MCP est le serveur hébergé officiel du Model Context Protocol (MCP) fourni par Notion. Il permet aux assistants et agents IA d'interagir de manière sécurisée et efficace avec les espaces de travail Notion en utilisant le standard ouvert MCP.

Au lieu de gérer des clés API ou d'auto-héberger, les utilisateurs se connectent via un simple OAuth 2.0 avec PKCE. Le serveur s'exécute sur https://mcp.notion.com/mcp (transport HTTP Streamable recommandé) et https://mcp.notion.com/sse (alternative).

Il est activement maintenu par Notion et optimisé pour les flux de travail IA modernes, remplaçant l'ancien notion-mcp-server open-source qui n'est plus activement maintenu.

Fonctionnalités principales

• Authentification OAuth sécurisée : Délimitation granulaire des permissions lors de la connexion — aucun jeton à longue durée de vie exposé.
• 20+ outils optimisés pour l'IA : Inclut notion-search (à travers l'espace de travail et les sources connectées comme Slack, Google Drive, Jira), requêtes de bases de données (mises à jour pour l'API du 2025-09-03 avec les sources de données), création de pages, ajout de blocs, mises à jour de propriétés, commentaires, et plus encore.
• Accès bidirectionnel en temps réel : Lire du contenu riche (automatiquement converti en Markdown pour l'efficacité des tokens), créer/mettre à jour des pages et bases de données, ajouter des commentaires.
• Zéro infrastructure : Entièrement hébergé et toujours à jour — pas de Docker, serveurs ou maintenance requis.
• Prise en charge du streaming : Transport moderne pour des réponses plus rapides et une meilleure expérience des agents.
• Compatibilité étendue avec les clients : Support natif dans Claude Desktop, Cursor, VS Code, ChatGPT (avec ajustements des noms d'outils), et les clients MCP personnalisés.

Comment ça fonctionne

Notion héberge à la fois le serveur MCP et l'API Notion sous-jacente. Les clients MCP dans vos outils IA découvrent automatiquement les outils disponibles, les invoquent via le langage naturel et reçoivent des résultats structurés. Un pipeline de génération de code convertit les schémas OpenAPI de Notion en outils MCP validés (en utilisant Zod), garantissant une haute qualité et cohérence.

Options de configuration

• Recommandée : Connexion en un clic via la galerie ou importation directe d'URL (https://mcp.notion.com/mcp).
• Claude : claude mcp add --transport http notion https://mcp.notion.com/mcp puis authentification via /mcp.
• Cursor : Ajouter comme serveur MCP global dans les paramètres.
• Clients personnalisés : Suivre le guide OAuth + PKCE de Notion pour créer vos propres intégrations.

Notion MCP vs Ancien serveur open-source

Le dépôt GitHub hérité (makenotion/notion-mcp-server) est toujours disponible mais n'est plus activement maintenu. Notion recommande fortement la version hébergée pour la sécurité, les performances, la facilité d'utilisation, et la compatibilité avec les dernières modifications de l'API.

Cas d'utilisation

• Travailleurs du savoir résumant des notes et créant automatiquement des points d'action.
• Développeurs référençant des spécifications/bases de données Notion directement dans Cursor ou Claude pendant le codage.
• Équipes construisant des agents autonomes qui gèrent des feuilles de route, wikis, tâches et commentaires.
• Créateurs de contenu générant et maintenant des documents vivants avec des références croisées en temps réel.

Outils pris en charge (liste partielle)

• notion-search — recherche en texte intégral puissante avec filtres.
• Opérations sur les bases de données et les sources de données (requête, création, mise à jour).
• Gestion des pages et des blocs (ajout, mise à jour du texte enrichi).
• Commentaires et listage des espaces de travail.

Les outils sont maintenus à jour en fonction de l'évolution de l'API Notion.

Pour commencer

Visitez la documentation officielle sur developers.notion.com/guides/mcp/mcp pour connecter vos outils d'IA dès aujourd'hui.

Le MCP Notion représente la norme pour une intégration transparente et sécurisée entre l'IA et les outils de productivité — le « USB-C pour les agents IA » dans l'écosystème Notion.