Notion MCP Server

Ein Server, der eine Verbindung zur Notion-API herstellt und Funktionen über Claudes Machine Context Protocol (MCP) bereitstellt.

Merkmale

• Durchsuchen Sie Notion-Seiten nach Titel oder Inhalt

• Seitendetails und Inhalte abrufen

• Abfragen von Notion-Datenbanken

• Erstellen Sie neue Seiten in Notion

Related MCP server: Notion MCP Server

Aufstellen

1. Klonen Sie dieses Repository:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

2. Installieren Sie Abhängigkeiten:

npm install

3. Erstellen Sie im Stammverzeichnis eine .env Datei mit folgendem Inhalt:

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

4. Holen Sie sich Ihren Notion-API-Schlüssel:

   • Gehen Sie zu https://www.notion.so/my-integrations

   • Erstellen einer neuen Integration

   • Kopieren Sie das „Interne Integrationstoken“

   • Fügen Sie dieses Token als Ihren NOTION_API_KEY in der .env Datei hinzu

5. Verbinden Sie Ihre Notion-Integration mit Ihrem Arbeitsbereich:

   • Gehen Sie zu einer Seite oder Datenbank in Ihrem Notion-Arbeitsbereich

   • Klicken Sie oben rechts auf das Menü „…“

   • Wählen Sie „Verbindungen hinzufügen“

   • Suchen und fügen Sie Ihre Integration hinzu

Ausführen des Servers

Starten Sie den Server im Entwicklungsmodus:

npm run dev

Oder im Produktionsmodus:

npm start

Der Server wird auf dem in Ihrer .env Datei angegebenen Port ausgeführt (Standard: 3000).

API-Endpunkte

Reguläre HTTP-Endpunkte

• POST /api/notion/search

  • Suchen Sie in Notion nach Seiten

  • Body: { "query": "search term" }

• POST /api/notion/page

  • Abrufen einer Seite nach ID

  • Text: { "page_id": "page-id-here" }

• POST /api/notion/database/query

  • Abfragen einer Datenbank

  • Text: { "database_id": "database-id-here", "filter": {}, "sorts": [] }

• POST /api/notion/page/create

  • Erstellen einer neuen Seite

  • Text: { "parent": {}, "properties": {}, "children": [] }

MCP-Integration

Der Server stellt unter /mcp/manifest.json ein MCP-Manifest bereit, das die verfügbaren Funktionen beschreibt.

Um eine MCP-Funktion aufzurufen, senden Sie eine POST-Anfrage an /api/notion/mcp/invoke mit der folgenden Struktur:

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

Verfügbare MCP-Funktionen

• search_pages – Notion-Seiten nach Titel oder Inhalt durchsuchen

• get_page - Ruft eine Notion-Seite nach ID ab

• query_database – Abfrage einer Notion-Datenbank

• create_page – Erstellen Sie eine neue Seite in Notion

Lizenz

MIT