Notion API Server

Reference video

Video on how to use Notion MCP

This is a custom server for easy use of the Notion API. It is implemented using Express.js and provides various functions of the Notion API as a REST API.

How to install

Install required packages:

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

Running the server:

node server.js

The server runs at http://localhost:3000 .

How to set up

Set your Notion API token in the NOTION_TOKEN variable in your server.js file:

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

If necessary, you can run it on a different port by modifying the PORT variable.

API Features

Search API

POST /api/search : Search pages and databases within your Notion workspace.

Database API

POST /api/databases : Create a database
GET /api/databases/:id : Query database
PATCH /api/databases/:id : Update database
POST /api/databases/:id/query : Database query

Page API

POST /api/pages : Create a page
GET /api/pages/:id : View page information
PATCH /api/pages/:id : Update page
GET /api/pages/:page_id/properties/:property_id : View page properties

Block API

GET /api/blocks/:id : Block query
GET /api/blocks/:id/children : View block contents
PATCH /api/blocks/:id : Update block
PATCH /api/blocks/:id/children : Add block content
DELETE /api/blocks/:id : Delete block

User API

GET /api/users : View user list
GET /api/users/:id : User search
GET /api/users/me : View your own user information

Comment API

POST /api/comments : Create a comment
GET /api/comments?block_id=... : View comments

Cursor MCP Integration

Add the following settings to .cursor/mcp.json file:

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

You can access the Notion API using MCP functions in Cursor while the server is running.

Usage examples

Example search request

// 페이지 검색 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));

Page creation example

// 새 페이지 생성 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));

Example of creating a database

// 데이터베이스 생성 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 Documentation

The API documentation is available at the following URL when running the server:

Swagger UI: http://localhost:3000/api-docs
OpenAPI schema: http://localhost:3000/openapi.json

Notion MCP Server