Notion API-Server

Referenzvideo

Video zur Verwendung von Notion MCP

Ein benutzerdefinierter Server zur einfachen Verwendung der Notion-API. Es wird mit Express.js implementiert und stellt verschiedene Funktionen der Notion-API als REST-API bereit.

Related MCP server: SystemPrompt MCP Notion Server

So installieren Sie

Installieren Sie die erforderlichen Pakete:

npm install express cors @notionhq/client swagger-jsdoc swagger-ui-express

Ausführen des Servers:

node server.js

Der Server läuft unter http://localhost:3000 .

So richten Sie ein

Legen Sie Ihr Notion-API-Token in der Variable NOTION_TOKEN in Ihrer Datei server.js fest:

const NOTION_TOKEN = '여기에_노션_API_토큰_입력';

Bei Bedarf können Sie es auf einem anderen Port ausführen, indem Sie die PORT-Variable ändern.

API-Funktionen

Such-API

POST /api/search : Durchsuchen Sie Seiten und Datenbanken in Ihrem Notion-Arbeitsbereich.

Datenbank-API

POST /api/databases : Erstellen Sie eine Datenbank
GET /api/databases/:id : Datenbank abfragen
PATCH /api/databases/:id : Datenbank aktualisieren
POST /api/databases/:id/query : Datenbankabfrage

Seiten-API

POST /api/pages : Eine Seite erstellen
GET /api/pages/:id : Seiteninformationen anzeigen
PATCH /api/pages/:id : Seite aktualisieren
GET /api/pages/:page_id/properties/:property_id : Seiteneigenschaften anzeigen

Block-API

GET /api/blocks/:id Blockabfrage
GET /api/blocks/:id/children : Blockinhalte anzeigen
PATCH /api/blocks/:id : Block aktualisieren
PATCH /api/blocks/:id/children : Blockinhalt hinzufügen
DELETE /api/blocks/:id : Block löschen

Benutzer-API

GET /api/users : Benutzerliste anzeigen
GET /api/users/:id : Benutzersuche
GET /api/users/me : Zeigen Sie Ihre eigenen Benutzerinformationen an

Kommentar-API

POST /api/comments : Einen Kommentar erstellen
GET /api/comments?block_id=... : Kommentare anzeigen

Cursor MCP-Integration

Fügen Sie .cursor/mcp.json die folgenden Einstellungen hinzu:

{ "mcpServers": { "customApi": { "url": "http://localhost:3000", "toolNameStrategy": "url-path-segments" } } }

Sie können mithilfe von MCP-Funktionen in Cursor auf die Notion-API zugreifen, während der Server läuft.

Anwendungsbeispiele

Beispiel einer Suchanfrage

// 페이지 검색 fetch('http://localhost:3000/api/search', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ filter: { value: "page", property: "object" } }) }) .then(response => response.json()) .then(data => console.log(data));

Beispiel für die Seitenerstellung

// 새 페이지 생성 fetch('http://localhost:3000/api/pages', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ parent: { page_id: "페이지_ID" }, properties: { title: { title: [ { text: { content: "새 페이지 제목" } } ] } } }) }) .then(response => response.json()) .then(data => console.log(data));

Beispiel für das Erstellen einer Datenbank

// 데이터베이스 생성 fetch('http://localhost:3000/api/databases', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ parent: { type: "page_id", page_id: "페이지_ID" }, title: [ { text: { content: "테스트 데이터베이스" } } ], properties: { "이름": { "title": {}, "description": "제목 항목" }, "상태": { "description": "작업 상태", "select": { "options": [ { "name": "진행 중", "color": "blue" }, { "name": "완료", "color": "green" } ] } } } }) }) .then(response => response.json()) .then(data => console.log(data));

API-Dokumentation

Die API-Dokumentation ist beim Ausführen des Servers unter der folgenden URL verfügbar:

Swagger-Benutzeroberfläche: http://localhost:3000/api-docs
OpenAPI-Schema: http://localhost:3000/openapi.json

Notion MCP Server