Notion MCP Server
Offizieller MCP-Server von Notion, mit dem KI-Agenten Seiten und Datenbanken eines Notion-Arbeitsbereichs durchsuchen, lesen und bearbeiten.
- Skill Road
- Notion MCP Server
Beschreibung
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.
Voraussetzungen
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.
Installationsanleitung
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.
Schnellstart
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.
claude mcp add --transport http notion https://mcp.notion.com/mcp
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.
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.
Schritt 1: 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.
Schritt 2: 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.
claude mcp add --transport http notion https://mcp.notion.com/mcp
Authentifizierung
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.
Benötigte Zugriffsrechte
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).
Übertragene oder gespeicherte Daten
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.
Sicherheitsrisiken
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.
Lizenz und Kosten
- Lizenz
- MIT
- Kosten
- kostenlos
Der MCP-Server selbst ist kostenlos; das Self-Hosting-Paket ist quelloffen (MIT-Lizenz). Vorausgesetzt wird ein Notion-Konto – Notion bietet einen kostenlosen Tarif sowie kostenpflichtige Pläne für Team- und Unternehmensfunktionen, die unabhängig vom MCP-Server abgerechnet werden.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- Notion
- Status
- Offizieller Server
- Betriebsart
- Lokal und Remote
- Aktuelle Version
- 2.5.1
- GitHub-Sterne
- 4,712
- Zuletzt geprüft
- 07.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.
Noch keine passenden Ratgeber vorhanden.