Notion MCP-Server

Ein Model Context Protocol (MCP)-Server, der Notion mit Claude verbindet – für Claude Desktop, Claude Code und jeden anderen MCP-fähigen Client.

Damit kann Claude direkt in deinem Notion-Workspace suchen, Seiten lesen und erstellen, Datenbanken abfragen und Inhalte bearbeiten.

Funktionen (Tools)

Alle Tools akzeptieren sowohl Notion-IDs als auch vollständige Notion-URLs.

Related MCP server: Notion MCP Server

Voraussetzungen

• Node.js 18 oder neuer

• Ein Notion-Konto mit einem Workspace

1. Notion-Integration erstellen

1. Öffne https://www.notion.so/profile/integrations

2. Klicke auf „Neue Integration“ und gib ihr einen Namen (z. B. „Claude“)

3. Wähle deinen Workspace aus und speichere

4. Kopiere den Internal Integration Token (beginnt mit ntn_ oder secret_)

Wichtig: Die Integration sieht nur Seiten, die du explizit freigibst. Öffne dazu in Notion die gewünschte Seite (oder eine übergeordnete Seite), klicke oben rechts auf ··· → Verbindungen → Verbindung hinzufügen und wähle deine Integration aus. Unterseiten erben die Freigabe automatisch.

2. Server installieren und bauen

git clone https://github.com/loberkehr-art/Code-mcp-Notion-.git
cd Code-mcp-Notion-
npm install
npm run build

3. Mit Claude verbinden

Claude Desktop

Trage den Server in die Konfigurationsdatei ein:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/Code-mcp-Notion-/dist/index.js"],
      "env": {
        "NOTION_API_KEY": "ntn_dein_token_hier"
      }
    }
  }
}

Danach Claude Desktop neu starten. Die Notion-Tools erscheinen im Tool-Menü (🔨).

Claude Code (CLI)

claude mcp add notion \
  --env NOTION_API_KEY=ntn_dein_token_hier \
  -- node /absoluter/pfad/zu/Code-mcp-Notion-/dist/index.js

Beispiele

Sobald der Server verbunden ist, kannst du Claude z. B. bitten:

• „Suche in Notion nach meinen Meeting-Notizen“

• „Lies die Seite ‚Projektplan‘ und fasse sie zusammen“

• „Erstelle in der Aufgaben-Datenbank einen Eintrag ‚Steuererklärung‘ mit Status ‚Offen‘“

• „Zeige alle Einträge der Datenbank, deren Status ‚In Arbeit‘ ist“

• „Hänge diese Zusammenfassung an meine Wochennotizen an“

Entwicklung

npm run dev      # Server direkt aus TypeScript starten (tsx)
npm run watch    # TypeScript im Watch-Modus kompilieren

Der Server kommuniziert über stdio (Standard-Ein-/Ausgabe) und loggt Statusmeldungen nach stderr, damit das MCP-Protokoll auf stdout ungestört bleibt.

Projektstruktur

src/
├── index.ts       # MCP-Server und Tool-Definitionen
├── markdown.ts    # Konvertierung Markdown ⇄ Notion-Blöcke
└── properties.ts  # Lesen und Schreiben von Seiten-Properties

Hinweise & Grenzen

• Die Notion-API erlaubt maximal 100 Blöcke pro Schreibvorgang – längere Inhalte werden automatisch in mehreren Aufrufen angehängt.

• Neue Seiten können nur unterhalb einer bestehenden Seite oder Datenbank angelegt werden (API-Einschränkung von Notion).

• Berechnete Property-Typen (formula, rollup, created_time, …) sind nur lesbar, nicht beschreibbar.

• Der Token gehört in die Umgebungsvariable NOTION_API_KEY – niemals ins Repository committen (.env ist in .gitignore).

Lizenz

MIT