Notion MCP Server einrichten

Der Notion MCP Server lässt sich auf zwei Wegen anbinden: als von Notion gehosteter Remote-Dienst mit OAuth-Anmeldung oder als lokal betriebener Self-Hosting-Server mit Integrations-Token. Notion empfiehlt inzwischen die gehostete Variante.

Welche Variante passt

Die gehostete Variante ist am schnellsten eingerichtet, braucht keinen lokalen Prozess und regelt den Zugriff über einen OAuth-Dialog. Die Self-Hosting-Variante ist sinnvoll, wenn der Datenverkehr das eigene Netz nicht verlassen soll oder wenn eine bestehende interne Integration weitergenutzt wird. Laut Projekt-README wird das Self-Hosting-Repository nur noch nachrangig gepflegt.

Gehostete Variante anbinden

Den Remote-Server im MCP-Client eintragen. In Claude Code:

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

In Cursor oder VS Code stattdessen einen Server-Eintrag mit der URL https://mcp.notion.com/mcp anlegen (in VS Code mit "type": "http"). Beim ersten Aufruf öffnet der Client ein Browserfenster für die OAuth-Autorisierung – dort den Arbeitsbereich wählen und bestätigen. Fällt der primäre Pfad aus, steht https://mcp.notion.com/sse als Rückfall bereit.

Self-Hosting-Variante anbinden

Unter notion.so/profile/integrations eine interne Integration anlegen und deren Token kopieren. Anschließend im Access-Tab der Integration genau die Seiten und Datenbanken freigeben, die der Agent sehen soll – alternativ auf der Zielseite über das Drei-Punkte-Menü "Connect to integration" wählen. Den Server dann per npx starten und NOTION_TOKEN als Umgebungsvariable setzen; alternativ das Docker-Image mcp/notion verwenden.

Zugriff eng halten

Der Agent kann alles lesen und ändern, was im gewählten OAuth-Umfang bzw. über die verbundene Integration erreichbar ist. Für automatisierte Abläufe eine eigene Integration mit möglichst wenigen freigegebenen Seiten verwenden und den Token wie ein Passwort behandeln. Arbeitsbereich-Eigentümer können verbundene MCP-Clients in den Notion-Einstellungen unter "Connections" einsehen und entfernen.

Einrichtung prüfen

Nach dem Verbinden mit einer harmlosen Aufgabe testen, etwa „Suche die Seite mit den Onboarding-Notizen und fasse sie zusammen". Prüfen, ob nur die erwarteten Seiten auftauchen, und im Zweifel den Freigabeumfang nachschärfen.

Häufige Verbindungsprobleme

Wenn die OAuth-Anmeldung im Browser nicht öffnet, prüfen, ob der Client Pop-ups oder neue Fenster blockiert – manche Terminal-Umgebungen ohne grafische Oberfläche können den Browser gar nicht starten und benötigen stattdessen eine manuelle Anmeldung über eine angezeigte URL. Bei der Self-Hosting-Variante führt ein abgelaufener oder widerrufener Integrations-Token zu Authentifizierungsfehlern; ein neuer Token aus den Kontoeinstellungen behebt das meist sofort.

Für Teams mit mehreren Arbeitsbereichen

Wer mehrere Notion-Arbeitsbereiche parallel nutzt, etwa einen für die eigene Firma und einen für ein Kundenprojekt, sollte den Server mit unterschiedlichen Namen in der Client-Konfiguration eintragen und bei jeder OAuth-Anmeldung explizit den richtigen Arbeitsbereich auswählen. So lässt sich verhindern, dass ein Agent versehentlich im falschen Arbeitsbereich Änderungen vornimmt.

Quelle: developers.notion.com/docs/mcp und developers.notion.com/docs/get-started-with-mcp sowie github.com/makenotion/notion-mcp-server, geprüft am 05.09.2026.