Notion MCP Server

Begriff-MCP-SM

Dieses Projekt implementiert einen MCP-Server für die Notion-API .

mcp-demo

Installation

1. Integration in Notion einrichten:

Gehen Sie zu https://www.notion.so/profile/integrations und erstellen Sie eine neue interne Integration oder wählen Sie eine vorhandene aus.

Erstellen eines Notion-Integrationstokens

Obwohl wir den Umfang der verfügbaren Notion-APIs einschränken (z. B. können Sie Datenbanken nicht über MCP löschen), besteht ein nicht zu vernachlässigendes Risiko für Arbeitsbereichsdaten, wenn diese LLMs ausgesetzt werden. Sicherheitsbewusste Benutzer sollten die Integrationsfunktionen weiter konfigurieren.

Sie können beispielsweise ein schreibgeschütztes Integrationstoken erstellen, indem Sie auf der Registerkarte „Konfiguration“ nur den Zugriff „Inhalte lesen“ gewähren:

Notion Integration Token-Funktionen zeigen „Gelesener Inhalt“ aktiviert an

2. Inhalte mit Integration verknüpfen:

Stellen Sie sicher, dass relevante Seiten und Datenbanken mit Ihrer Integration verbunden sind.

Besuchen Sie dazu diese Seite, klicken Sie auf die drei Punkte und wählen Sie „Mit Integration verbinden“.

Hinzufügen eines Integrationstokens zu Notion-Verbindungen

3. Hinzufügen der MCP-Konfiguration zu Ihrem Client:

Verwenden von npm:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Docker verwenden:

Es gibt zwei Möglichkeiten, den MCP-Server mit Docker auszuführen:

Option 1: Verwenden des offiziellen Docker Hub-Image:

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Dieser Ansatz:

Verwendet das offizielle Docker Hub-Image
Behandelt JSON-Escape über Umgebungsvariablen ordnungsgemäß
Bietet eine zuverlässigere Konfigurationsmethode

Option 2: Lokales Erstellen des Docker-Images:

Sie können das Docker-Image auch lokal erstellen und ausführen. Erstellen Sie zunächst das Docker-Image:

docker-compose build

Fügen Sie dann Folgendes zu Ihrer .cursor/mcp.json oder claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server"
      ]
    }
  }
}

Vergessen Sie nicht ntn_**** durch Ihr Integrationsgeheimnis zu ersetzen. Sie finden es auf der Registerkarte „Integrationskonfiguration“:

Kopieren Ihres Integrationstokens von der Registerkarte „Konfiguration“ im Entwicklerportal

Beispiele

Mit der folgenden Anleitung

Comment "Hello MCP" on page "Getting started"

Die KI plant zwei API-Aufrufe, v1/search und v1/comments , korrekt, um die Aufgabe zu erfüllen

In ähnlicher Weise führt die folgende Anweisung dazu, dass der übergeordneten Seite „Entwicklung“ eine neue Seite mit dem Namen „Notion MCP“ hinzugefügt wird.

Add a page titled "Notion MCP" to page "Development"

Sie können die Inhalts-ID auch direkt referenzieren

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Entwicklung

Bauen

npm run build

Ausführen

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Veröffentlichen

npm publish --access public

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Ein MCP-Server, der es KI-Assistenten ermöglicht, mit der Notion-API zu interagieren, sodass sie mithilfe natürlicher Sprachbefehle Inhalte in Notion-Arbeitsbereichen suchen, lesen, kommentieren und erstellen können.

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
1,230
699
TypeScript
MIT License
SystemPrompt MCP Notion Server
Ejb503
A
security
F
license
A
quality
A high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.
Last updated -
8
10
13
TypeScript
Notion MCP Server
ramidecodes
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.
Last updated -
17
77
7
TypeScript
Apache 2.0
notion-mcp-server
awkoy
A
security
A
license
A
quality
Notion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.
Last updated -
13
194
91
TypeScript
MIT License

View all related MCP servers

Notion MCP Server