Notion MCP Server

Der Notion MCP Server implementiert das Model Context Protocol und gibt KI-Agenten Zugriff auf einen Notion-Arbeitsbereich: Seiten und Datenbanken durchsuchen, Seiteninhalte als Markdown lesen und schreiben, Datenbankeinträge abfragen und anlegen, Seiten verschieben sowie Kommentare erstellen. Notion nennt 22 Werkzeuge, die bewusst auf einen sparsamen Token-Verbrauch ausgelegt sind; Seiteninhalte werden als Markdown statt als Block-JSON übergeben.

Gehostete Variante (empfohlen)

Notion betreibt den Server als gehosteten Remote-Dienst unter https://mcp.notion.com/mcp (Streamable HTTP) mit https://mcp.notion.com/sse als Rückfallpfad. Die Anmeldung läuft über einen OAuth-Autorisierungsfluss – der Client öffnet ein Browserfenster, in dem man die Verbindung für den eigenen Arbeitsbereich bestätigt. Ein lokaler Prozess ist nicht nötig.

Self-Hosting-Variante

Alternativ lässt sich das quelloffene Paket @notionhq/notion-mcp-server (MIT-Lizenz, zum Prüfzeitpunkt Version 2.5.1) lokal per npx oder als Docker-Image mcp/notion betreiben. Hier erfolgt die Authentifizierung über einen Integrations-Token (NOTION_TOKEN) einer internen Notion-Integration. Laut README priorisiert Notion inzwischen den gehosteten Server und könnte das Self-Hosting-Repository künftig einstellen.

Einrichtung der gehosteten Variante in Claude Code:

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

Warum die gehostete Variante bevorzugt wird

Notion hat die Priorität klar auf den gehosteten Server verschoben, weil er ohne lokale Prozesse, ohne separate Token-Verwaltung und ohne Update-Pflege auskommt: Ein OAuth-Klick genügt, und Notion kümmert sich um Betrieb und Aktualisierung. Das Self-Hosting-Paket bleibt zwar funktionsfähig, wird laut README aber nur noch nachrangig gepflegt und könnte künftig eingestellt werden. Für neue Anbindungen ist die gehostete Variante deshalb die naheliegende Wahl, während bestehende Self-Hosting-Setups nicht sofort migriert werden müssen.

Typische Einsatzszenarien

Der Server eignet sich für Aufgaben wie das automatische Zusammenfassen langer Wissensdatenbank-Seiten, das Anlegen strukturierter Meeting-Notizen direkt aus einem Gespräch mit dem Agenten, das Pflegen von Aufgabenlisten in einer Notion-Datenbank oder das Durchsuchen eines Arbeitsbereichs nach Informationen, die über mehrere Seiten verteilt sind. Wegen des sparsamen Token-Verbrauchs durch Markdown-Antworten eignet sich der Server auch für Workflows mit vielen aufeinanderfolgenden Notion-Abfragen, ohne dass das Kontextfenster des Modells schnell voll wird.

Für wen sich der Notion MCP Server eignet

Teams, die Notion bereits als zentrale Wissensdatenbank oder Projektmanagement-Tool nutzen, profitieren am meisten, weil sich damit ein KI-Agent direkt in bestehende Arbeitsabläufe einbinden lässt, ohne Inhalte manuell zu kopieren. Für Einzelpersonen, die Notion nur gelegentlich nutzen, lohnt sich der Aufwand einer Integration eher weniger; hier reicht oft die reguläre Notion-Oberfläche.

Häufige Fragen

Muss ich für den Notion MCP Server programmieren können? Nein, die gehostete Variante lässt sich ohne Code über OAuth einrichten; nur die Self-Hosting-Variante erfordert Umgang mit npx, Docker oder einer internen Integration. Kann der Agent versehentlich Inhalte löschen? Nur innerhalb des freigegebenen Umfangs; mit einer eng begrenzten Integration oder OAuth-Freigabe lässt sich das Risiko deutlich reduzieren. Funktioniert der Server mit privaten Notion-Arbeitsbereichen? Ja, der Zugriff richtet sich exakt nach dem Arbeitsbereich und den Seiten, für die die Verbindung bestätigt wurde.

Ein Notion-Konto mit Zugriff auf den gewünschten Arbeitsbereich. Für die gehostete Variante genügt ein MCP-Client mit Unterstützung für Remote-Server über HTTP und OAuth. Für die Self-Hosting-Variante zusätzlich Node.js (npx) oder Docker sowie eine interne Notion-Integration mit Token.

Für die gehostete Variante den Remote-Server im MCP-Client eintragen, etwa in Claude Code mit claude mcp add --transport http notion https://mcp.notion.com/mcp, in Cursor über einen mcpServers-Eintrag mit "url": "https://mcp.notion.com/mcp" oder in VS Code über einen servers-Eintrag mit "type": "http". Beim ersten Aufruf öffnet der Client den OAuth-Dialog; dort den Arbeitsbereich auswählen und die Verbindung bestätigen.

Für die Self-Hosting-Variante in der internen Integration unter notion.so/profile/integrations einen Token erzeugen, die gewünschten Seiten im Access-Tab der Integration freigeben (oder auf der Zielseite über das Drei-Punkte-Menü "Connect to integration" wählen) und den Server per npx starten, wobei NOTION_TOKEN als Umgebungsvariable gesetzt wird. Ein Docker-Image mcp/notion steht ebenfalls bereit.

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

Gehostete Variante: OAuth-Autorisierungsfluss pro Arbeitsbereich, im Client ausgelöst. Self-Hosting-Variante: Integrations-Token (NOTION_TOKEN) einer internen Notion-Integration, optional Bearer-Token beim HTTP-Transport.

Die effektiven Rechte entsprechen dem freigegebenen Umfang: Bei der gehosteten Variante legt der OAuth-Fluss fest, auf welche Bereiche des Arbeitsbereichs der Agent zugreifen darf; bei der Self-Hosting-Variante bestimmen die im Access-Tab der Integration verbundenen Seiten und Datenbanken den Zugriff. Innerhalb dieses Rahmens sind Lese- und Schreibaktionen möglich (Seiten anlegen, Inhalte ändern, Kommentare schreiben).

Anfragen und Werkzeugparameter gehen an die Notion-API. Antworten können Inhalte beliebiger freigegebener Seiten und Datenbanken enthalten und werden an den MCP-Client sowie dessen Sprachmodell weitergegeben. Bei der gehosteten Variante läuft die Verbindung über den von Notion betriebenen Server unter mcp.notion.com; bei der Self-Hosting-Variante läuft der Server lokal, spricht aber weiterhin die Notion-API an. Arbeitsbereich-Eigentümer können den Zugriff von MCP-Clients in den Notion-Einstellungen unter "Connections" verwalten.

Ein zu weit gefasster OAuth-Umfang oder eine Integration mit Zugriff auf viele Seiten ermöglicht einem Agenten – oder einem kompromittierten Client – weitreichende Lese- und Schreibaktionen im Arbeitsbereich, bis hin zum Überschreiben oder Verschieben produktiver Dokumente. Nur die tatsächlich benötigten Seiten freigeben, für automatisierte Agenten eine eigene Integration mit engem Zugriff verwenden, den Self-Hosting-Token wie ein Passwort behandeln und die verbundenen Clients regelmäßig in den Notion-Einstellungen prüfen.