n24q02m/better-notion-mcp

Was macht better-notion-mcp?

Markdown-zentrierter Notion-API-Server für KI-Agenten – 10 zusammengesetzte Tools ersetzen über 28 Endpunktaufrufe.

Übersicht

Dieser MCP-Server vereinfacht die Interaktion mit der Notion-API für KI-Agenten erheblich. Statt mit der komplexen, blockbasierten API von Notion zu arbeiten, können Agenten Markdown-Inhalte senden und empfangen. Die 10 bereitgestellten Werkzeuge decken die häufigsten Anwendungsfälle ab – vom Lesen und Erstellen von Seiten bis hin zur Abfrage von Datenbanken – und fassen dabei jeweils mehrere native API-Aufrufe in einem Schritt zusammen.

Plattformen

• Claude Code – vollständig kompatibel
• Cursor – getestet und funktionsfähig
• Andere MCP-kompatible Agenten – sollte mit geringfügigen Anpassungen funktionieren

Tools

Tool	Beschreibung	Ersetzt Endpunkte
read_page	Liest eine Notion-Seite und gibt sie als Markdown zurück	GET /pages/{id} + GET /blocks/{id}
create_page	Erstellt eine Seite aus Markdown-Inhalten	POST /pages + mehrere PATCH /blocks
update_page	Aktualisiert eine Seite mit Markdown-Diff	GET /pages/{id} + PATCH /pages/{id} + PATCH /blocks
query_database	Fragt eine Notion-Datenbank ab und gibt Ergebnisse als Markdown-Tabelle zurück	POST /databases/{id}/query
list_databases	Listet verfügbare Datenbanken auf	GET /search + Filterung
append_blocks	Fügt Markdown-Blöcke an eine bestehende Seite an	PATCH /blocks/{id}/children
search_pages	Durchsucht Notion nach Seiten	POST /search
get_page_property	Ruft den Wert einer Seiteneigenschaft ab	GET /pages/{id}/properties/{id}
create_database	Erstellt eine Datenbank aus einer Markdown-Tabellenstruktur	POST /databases + Erstellen von Seiten
delete_block	Löscht einen Block anhand seiner ID	DELETE /blocks/{id}

Voraussetzungen

• Notion-Integration: Erstelle eine Integration in der Notion-Admin-Oberfläche und erhalte ein NOTION_API_KEY.
• Notion-Seite teilen: Teile die gewünschten Notion-Seiten oder -Datenbanken mit der Integration (Einstellungen > Freigabe > Integration einladen).

Einrichtung

Claude Code

Füge in deiner claude_agent.json oder als Umgebungsvariable hinzu:

{
  "mcpServers": {
    "better-notion-mcp": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-notion-mcp"],
      "env": {
        "NOTION_API_KEY": "ntn_your_api_key_here"
      }
    }
  }
}

Cursor

Füge in den Cursor-Einstellungen (MCP-Server) ein:

{
  "name": "better-notion-mcp",
  "command": "npx",
  "args": ["-y", "@n24q02m/better-notion-mcp"],
  "env": {
    "NOTION_API_KEY": "ntn_your_api_key_here"
  }
}

Lizenz

MIT – siehe LICENSE für Details.