Notion MCP

Überblick

Notion MCP ist der offizielle gehostete Model Context Protocol (MCP)-Server von Notion. Er ermöglicht KI-Assistenten und Agenten eine sichere und effiziente Interaktion mit Notion-Arbeitsbereichen über den offenen MCP-Standard.

Anstatt API-Schlüssel zu verwalten oder selbst zu hosten, verbinden sich Benutzer über einen einfachen OAuth 2.0-Flow mit PKCE. Der Server läuft unter https://mcp.notion.com/mcp (empfohlener Streamable HTTP-Transport) und https://mcp.notion.com/sse (Fallback).

Er wird aktiv von Notion gepflegt und für moderne KI-Workflows optimiert. Er ersetzt den veralteten Open-Source-Server notion-mcp-server, der nicht mehr aktiv gewartet wird.

Hauptmerkmale

• Sichere OAuth-Authentifizierung: Granulare Berechtigungsfestlegung während der Verbindung – keine langlebigen Tokens werden exponiert.
• 20+ für KI optimierte Werkzeuge: Beinhaltet notion-search (über den Arbeitsbereich und verbundene Quellen wie Slack, Google Drive, Jira), Datenbankabfragen (aktualisiert für die API vom 2025-09-03 mit Datenquellen), Seitenerstellung, Blockanfügung, Eigenschaftenaktualisierung, Kommentare und mehr.
• Echtzeit-Zugriff in beide Richtungen: Lesen von umfangreichen Inhalten (automatisch zu Markdown konvertiert für Token-Effizienz), Erstellen/Aktualisieren von Seiten und Datenbanken, Hinzufügen von Kommentaren.
• Keine Infrastruktur: Vollständig gehostet und stets aktuell – kein Docker, keine Server und keine Wartung erforderlich.
• Streaming-Unterstützung: Moderner Transport für schnellere Antworten und bessere Agentenerfahrung.
• Breite Client-Kompatibilität: Native Unterstützung in Claude Desktop, Cursor, VS Code, ChatGPT (mit Anpassungen der Werkzeugnamen) und benutzerdefinierten MCP-Clients.

Funktionsweise

Notion hostet sowohl den MCP-Server als auch die zugrundeliegende Notion-API. MCP-Clients in Ihren KI-Tools entdecken automatisch verfügbare Werkzeuge, rufen sie über natürliche Sprache auf und erhalten strukturierte Ergebnisse. Eine Code-Generierungspipeline konvertiert Notions OpenAPI-Schemata in validierte MCP-Werkzeuge (unter Verwendung von Zod) und stellt so hohe Qualität und Konsistenz sicher.

Einrichtungsoptionen

• Empfohlen: Ein-Klick-Verbindung über die Galerie oder direkter URL-Import (https://mcp.notion.com/mcp).
• Claude: claude mcp add --transport http notion https://mcp.notion.com/mcp und dann Authentifizierung über /mcp.
• Cursor: Als globalen MCP-Server in den Einstellungen hinzufügen.
• Benutzerdefinierte Clients: Folgen Sie Notions OAuth + PKCE-Anleitung für den Aufbau eigener Integrationen.

Notion MCP vs. Legacy Open-Source Server

Das alte GitHub-Repository (makenotion/notion-mcp-server) ist noch verfügbar, wird aber nicht mehr aktiv gepflegt. Notion empfiehlt dringend die gehostete Version aufgrund von Sicherheit, Leistung, Benutzerfreundlichkeit und Kompatibilität mit den neuesten API-Änderungen.

Anwendungsfälle

• Wissensarbeiter, die Notizen zusammenfassen und automatisch Aktionspunkte erstellen.
• Entwickler, die direkt in Cursor oder Claude während der Programmierung auf Notion-Spezifikationen/Datenbanken verweisen.
• Teams, die autonome Agenten aufbauen, die Roadmaps, Wikis, Aufgaben und Kommentare verwalten.
• Content-Ersteller, die lebendige Dokumente mit Echtzeit-Querverweisen generieren und pflegen.

Unterstützte Tools (Auszug)

• notion-search — leistungsstarke Volltextsuche mit Filtern.
• Datenbank- und Datenquellenoperationen (Abfragen, Erstellen, Aktualisieren).
• Seiten- und Blockverwaltung (Anhängen, Rich-Text aktualisieren).
• Kommentare und Workspace-Auflistung.

Die Tools werden kontinuierlich an die sich weiterentwickelnde Notion-API angepasst.

Erste Schritte

Besuchen Sie die offizielle Dokumentation unter developers.notion.com/guides/mcp/mcp, um noch heute Ihre KI-Tools zu verbinden.

Notion MCP setzt den Standard für nahtlose, sichere KI-zu-Produktivitätstool-Integration – das „USB-C für KI-Agenten“ im Notion-Ökosystem.