Notion MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Offiziell – von Notion veröffentlicht, folgt ihrer API treu
Datenbankabfragen mit Filter/Sortierung – behandeln Sie Notion wie einen strukturierten Datenspeicher
Schreibzugriffe auf Block-Ebene – fügen Sie spezifische Blöcke an, aktualisieren Sie sie, archivieren Sie sie, nicht ganze Seiten
Seitensuche im gesamten Workspace (was Sie mit der Integration geteilt haben)

Live-Demo

In der Praxis

notion.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "notion",
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "notion": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@notionhq/notion-mcp-server"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add notion -- npx -y @notionhq/notion-mcp-server

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Notion

Lassen Sie einen Agent Ihre PRD auf Lücken überprüfen

👤 PMs, Tech Leads ⏱ ~15 min intermediate

Wann einsetzen: Sie haben eine Spezifikation entworfen und möchten eine kritische Überprüfung, bevor Sie sie mit dem Engineering-Team teilen.

Voraussetzungen

Notion-Token für interne Integration — notion.so/my-integrations → Neue Integration → Secret kopieren
Seite, die mit der Integration geteilt ist — Auf der Seite: ••• → Verbindungen → Integration hinzufügen

Ablauf

Abrufen des Seiteninhalts

Lesen Sie die Notion-Seite unter <URL>. Fassen Sie in 5 Stichpunkten zusammen, was diese Spezifikation vorschlägt.✓ Kopiert

→ Genaue einseitige Zusammenfassung – zeigt, dass der Agent sie verstanden hat
Unterbestimmte Bereiche identifizieren

Listen Sie alle Stellen auf, wo die Spezifikation vage ist: fehlende Fehlerfälle, undefiniertes Verhalten an den Grenzen, unklar verteilte Verantwortung, kein Rollout-Plan, keine Erfolgsmessgröße.✓ Kopiert

→ Nummerierte Liste von Lücken mit Seitenverweisen
Fragen für die Überprüfung entwerfen

Konvertieren Sie diese Lücken in 5–10 spezifische Fragen, die ein überprüfender Ingenieur stellen würde. Fügen Sie sie als neuen Abschnitt ‚Offene Fragen' zur Notion-Seite hinzu.✓ Kopiert

→ Frage-Block zur Seite hinzugefügt

Ergebnis: Eine straffere Spezifikation plus ein Abschnitt ‚Offene Fragen', der die richtigen Gespräche vor dem Überprüfungstreffen in Gang setzt.

Fallstricke

Agent erfindet Details, die nicht in der Spezifikation vorhanden sind — In der Anfrage bestehen Sie darauf: ‚Markieren Sie nur Lücken; erfinden Sie keine Fakten; zitieren Sie den Abschnitt, in dem jede Lücke auftritt'
Lange Spezifikationen werden beim Abrufen abgeschnitten — Verwenden Sie retrieve_block_children seitenweise, wenn die Seite viele Blöcke hat; verlassen Sie sich nicht auf einen einzelnen get_page-Aufruf

Kombinieren mit: linear

Automatisch tägliche Standup-Seite aus Linear + GitHub generieren

👤 Engineering Manager, Scrum Master ⏱ ~10 min intermediate

Wann einsetzen: Sie betreiben eine tägliche Notion-Standup-Seite und möchten sie mit der Aktivität von gestern vorab ausfüllen.

Voraussetzungen

Eine Notion-Datenbank ‚Standups' — Hat Eigenschaften: Datum (Datum), Team (Auswahl), Status (Rich Text)

Ablauf

Aktivität von gestern sammeln

Aus Linear die in den letzten 24h für das ENG-Team abgeschlossenen Probleme auflisten. Aus GitHub die von unserem Team zusammengeführten PRs auflisten.✓ Kopiert

→ Kombinierte Aktivitätsliste
Standup-Inhalt aufbauen

Formatieren als: Erfolge (ausgeliefert), Laufend (offene PRs), Blockierungen (mit ‚blockiert' gekennzeichnete Probleme), Fokus heute (Probleme in Bearbeitung). Halten Sie jeden Abschnitt unter 5 Stichpunkten.✓ Kopiert

→ Formatierte Blockliste
Notion-Seite erstellen

Erstellen Sie eine neue Seite in der Standups-Datenbank. Datum = heute, Team = ENG, und fügen Sie den Inhalt als strukturierte Blöcke ein (h2 pro Abschnitt).✓ Kopiert

→ Seiten-URL zurückgegeben

Ergebnis: Eine vorab ausgefüllte Standup-Seite, die für die 9-Uhr-Synchronisierung bereit ist und 15 Minuten Durcheinander spart.

Fallstricke

Datenbank-Eigenschaftsnamen sind Groß- und Kleinschreibung empfindlich und müssen genau übereinstimmen — Listen Sie Eigenschaften mit retrieve_database vor dem ersten Lauf auf und codieren Sie die exakten Schlüssel fest

Kombinieren mit: linear · github

Erstellen Sie einen Slack-ready Q&A-Bot über Ihre Notion-Dokumente

👤 Ops Leads, Support Manager ⏱ ~20 min intermediate

Wann einsetzen: Neue Mitarbeiter stellen immer wieder die gleichen Fragen. Ihre Antworten sind bereits in Notion geschrieben – nur nicht auffindbar.

Voraussetzungen

Onboarding-Dokumente befinden sich in einem bekannten Notion-Space — Teilen Sie die übergeordnete Seite mit der Integration, damit alle untergeordneten Seiten Zugriff erben

Ablauf

Workspace durchsuchen

Durchsuchen Sie Notion nach Seiten, die mit ‚[Benutzerfrage]' übereinstimmen. Geben Sie die Top 5 Seitentitel und URLs zurück.✓ Kopiert

→ Rangierte Ergebnisliste
Die relevantesten lesen

Rufen Sie für die Top 2 Ergebnisse den vollständigen Inhalt ab. Zitieren Sie die Abschnitte, die die Frage beantworten.✓ Kopiert

→ Wörtliche Zitate + Quellen-URLs
Mit Zitationen antworten

Beantworten Sie die Frage des Benutzers in 2–3 Sätzen, nur auf Basis dieser Zitate. Beenden Sie mit: ‚Quelle: <url>'. Wenn die Dokumente die Frage nicht tatsächlich beantworten, teilen Sie dies mit.✓ Kopiert

→ Antwort mit Zitation oder ehrlich ‚nicht in Dokumenten'

Ergebnis: Fundierte Antworten, die es Menschen ermöglichen, ihren eigenen Weg zur Ursprungsquelle zu finden – nicht mehr ‚wo ist X?' auf Slack.

Fallstricke

Agent erfindet eine plausible Antwort, wenn die Dokumente sie tatsächlich nicht abdecken — Explizite Anweisung: ‚Wenn die abgerufenen Zitate die Frage nicht beantworten, antworte mit: Ich sehe das nicht in unseren Dokumenten – keine Vermutungen'
Die Notion-Suche basiert auf Schlüsselwörtern und verpasst semantische Treffer — Wenn die Ergebnisse dünn wirken, kombinieren Sie mit einem richtigen RAG-Stack (betten Sie Notion-Inhalte in eine Vektor-DB ein)

Konvertieren Sie Besprechungsnotizen in Linear-Probleme

👤 Tech Leads, PMs ⏱ ~10 min beginner

Wann einsetzen: Sie haben während einer Besprechung in Notion grobe Notizen gemacht. Jetzt müssen Sie die Aktionselemente extrahieren.

Voraussetzungen

Linear MCP installiert — Siehe Linear-Anleitung

Ablauf

Besprechungsseite lesen

Lesen Sie die Notion-Seite unter <URL>. Extrahieren Sie jedes Aktionselement – alles, das als ‚X wird Y tun' oder ‚wir sollten Z tun' formuliert ist.✓ Kopiert

→ Liste mit Besitzer, falls erwähnt
Vor dem Erstellen bestätigen

Zeigen Sie mir die Aktionsliste. Schlagen Sie für jedes einen Linear-Titel, Team und Priorität vor. Erstellen Sie noch nicht.✓ Kopiert

→ Trockentest-Tabelle zur Überprüfung durch Menschen
Genehmigte Elemente erstellen

Erstellen Sie Linear-Probleme für die Elemente 1, 3 und 5. Verknüpfen Sie jedes mit der Notion-Besprechungsseite.✓ Kopiert

→ Linear-Problem-URLs zurückgegeben

Ergebnis: Besprechungsmaßnahmen, die tatsächlich verfolgt werden, anstatt auf einer Notion-Seite verloren zu gehen, die niemand erneut besucht.

Fallstricke

Agent behandelt jeden informativen Stichpunkt als eine Aktion — In der Anfrage: ‚nur Elemente mit klarem Besitzer ODER einem Lieferergebnis – alle anderen verwerfen'

Kombinieren mit: linear

Überprüfen Sie Ihre Notion-Dokumente auf Veraltung

👤 Dokumentations-Leads, DevEx-Ingenieure ⏱ ~20 min intermediate

Wann einsetzen: Vierteljährliche Bereinigung – finden Sie Dokumente, die seit mehr als 6 Monaten nicht mehr aktualisiert wurden und wahrscheinlich veraltet sind.

Voraussetzungen

Eine Stammseite für den Dokumentationsbereich — z. B. /Engineering/Docs – mit der Integration geteilt

Ablauf

Unterseiten mit Zeitstempeln auflisten

Listen Sie alle untergeordneten Seiten unter der Seite ‚Engineering Docs' auf. Für jede: Titel, URL, Zeitpunkt der letzten Bearbeitung, zuletzt bearbeitet von.✓ Kopiert

→ Vollständiges Inventar
Nach veralteten Seiten filtern

Filtern Sie auf Seiten, die vor mehr als 180 Tagen zuletzt bearbeitet wurden. Gruppieren Sie nach oberster Ebene.✓ Kopiert

→ Veraltete Liste pro Abschnitt
Zur Überprüfung kennzeichnen

Fügen Sie für jede veraltete Seite oben einen Hinweis-Block hinzu: ‚⚠ Überprüfung erforderlich – zuletzt aktualisiert <Datum>. Kontaktieren Sie <Zuletzt-Bearbeiter> zur Bestätigung.'✓ Kopiert

→ Seiten mit Überprüfungs-Banner aktualisiert

Ergebnis: Ein Dokumentationsbereich, in dem Veraltung sichtbar ist, nicht versteckt – und Besitzer erhalten einen Hinweis, um entweder zu aktualisieren oder zu löschen.

Fallstricke

Einige Seiten sind bewusst archiviert (ADRs, Nachbesprechungen) und sollten das Banner NICHT erhalten — Filtern Sie nach Tag oder übergeordneter Seite – schließen Sie alles unter /Archive oder mit ‚historisch' gekennzeichnete aus

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

notion + linear

Gerüst für ein Linear-Projekt aus einer Notion-PRD

Lesen Sie die Notion-PRD unter <URL>, extrahieren Sie Lieferergebnisse, und erstellen Sie ein passendes Linear-Projekt mit Problemen, die nach Meilensteinen gruppiert sind.✓ Kopiert

notion + github

Halten Sie eine README mit einem Notion-Design-Dokument synchron

Lesen Sie die Notion-Seite ‚<API Design>' und aktualisieren Sie die README.md in unserem API-Repository, um sie anzupassen – öffnen Sie einen PR mit dem Diff.✓ Kopiert

notion + sentry

Veröffentlichen Sie wöchentliche Engineering-Qualitätsberichte in einer Notion-Datenbank

Ziehen Sie die Sentry-Fehlerstatistiken dieser Woche pro Projekt und erstellen Sie eine neue Seite in der Notion-Datenbank ‚Wöchentliche Qualität'.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
search	query, filter?: {property, value}	Ermittlung – finden Sie Seiten nach Schlüsselwort im gesamten Workspace	1 API-Aufruf
retrieve_page	page_id	Abrufen von Seiten-Metadaten/Eigenschaften – keine Inhaltsblöcke	1 API-Aufruf
retrieve_block_children	block_id, start_cursor?	Lesen des tatsächlichen Seiteninhalts – rufen Sie wiederholt auf, bis keine next_cursor vorhanden ist	1 API-Aufruf (möglicherweise Paginierung erforderlich)
append_block_children	block_id, children: Block[]	Fügen Sie Inhalte zu einer Seite oder unter einen spezifischen Block hinzu	1 API-Aufruf
update_block	block_id, {type}: {...}	Bearbeiten Sie Text/Inhalt eines vorhandenen Blocks an Ort und Stelle	1 API-Aufruf
create_page	parent: {database_id}\|{page_id}, properties, children?	Erstellen Sie eine neue Seite – unter einer übergeordneten Seite oder in einer Datenbank	1 API-Aufruf
query_database	database_id, filter?, sorts?	Strukturierte Abfrage – filtern/sortieren Sie Einträge in einer Datenbank	1 API-Aufruf
update_page	page_id, properties	Aktualisieren Sie Eigenschaften auf Seitenebene (Status, Tags, Datum)	1 API-Aufruf
retrieve_database	database_id	Überprüfen Sie Eigenschaftsnamen/Typen vor dem Schreiben	1 API-Aufruf

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Notion: durchschnittlich 3 Anfragen/Sekunde pro Integration, Bursts erlaubt. Wird 429 aggressiv bei großem Maßstab.
Tokens pro Aufruf: 500–3000 Token pro Seite je nach Blockanzahl
Kosten in €: Kostenlos – API in jedem Notion-Plan enthalten
Tipp: Seiten mit vielen verschachtelten Blöcken sind teuer, vollständig zu lesen. Suchen Sie zuerst, rufen Sie nur gezielt Seiten ab.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: read_content

Credential-Speicherung: Integrationsgeheimnis in der Umgebungsvariablen NOTION_API_KEY

Datenabfluss: Alle Aufrufe an api.notion.com

Niemals gewähren: update_content insert_content

Fehlerbehebung

Häufige Fehler und Lösungen

object_not_found

Seite existiert, ist aber nicht mit Ihrer Integration geteilt. Öffnen Sie die Seite → ••• → Verbindungen → Integration hinzufügen.

validation_error on create_page

Eigenschaftsnamen/Typen in Ihrer Last stimmen nicht mit dem Datenbankschema überein. Rufen Sie retrieve_database zuerst auf und kopieren Sie die exakten Schlüssel.

429 rate limited

Notion ist auf ~3 Anfragen/Sekunde begrenzt. Fügen Sie einen 350-ms-Schlaf zwischen Schreibvorgängen ein oder führen Sie Batches über append_block_children durch (senden Sie 100 Blöcke pro Aufruf, nicht 100 Aufrufe).

Page content looks empty

retrieve_page gibt nur Metadaten zurück – Inhalte befinden sich in Blöcken. Rufen Sie retrieve_block_children auf, um den tatsächlichen Text zu erhalten.

Alternativen

Notion vs. andere

Alternative	Wann stattdessen	Kompromiss
Confluence MCP	Ihre Organisation nutzt Confluence/Atlassian statt Notion	Schwereres Berechtigungsmodell; Agent-Workflows sind tendenziell langsamer
Obsidian / filesystem MCP	Ihre Wissensdatenbank besteht aus lokalen Markdown-Dateien	Keine Multi-User-Synchronisierung oder Berechtigungen, aber null API-Kosten und sofortige Lesevorgänge

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen