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 Funktionen der Integration 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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

Ein MCP-Server, der die Interaktion in natürlicher Sprache mit der Notion-API ermöglicht und es Benutzern ermöglicht, in ihrem Notion-Arbeitsbereich zu suchen, Kommentare abzugeben, Seiten zu erstellen und auf Inhalte zuzugreifen.

Related MCP Servers

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
Salesforce MCP Server
tsmztech
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
87
15
TypeScript
MIT License
Salesforce MCP Server
SurajAdsul
A
security
A
license
A
quality
An MCP server implementation that integrates Claude with Salesforce, enabling natural language interactions with Salesforce data and metadata for querying, modifying, and managing objects and records.
Last updated -
7
18
4
TypeScript
MIT License
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
275
91
TypeScript
MIT License

View all related MCP servers

Notion MCP Server