Notion MCP Server

Integrations

Provides a REST API interface for interacting with Notion's API, allowing for searching, database operations (creation, querying, updating), page management, block manipulation, user information retrieval, and comment functionality.
Integrates Swagger UI to provide interactive API documentation, available at the /api-docs endpoint with OpenAPI schema accessible at /openapi.json.

Notion API Server

Reference video

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

A custom server that provides a REST API interface for Notion, allowing easy access to Notion's functionality through Cursor's MCP feature.

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,398
699
TypeScript
MIT License
Notion MCP Server
orbit-logistics
-
security
F
license
-
quality
Enables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.
Last updated -
41
17
TypeScript
Notion MCP Server
ccabanillas
-
security
A
license
-
quality
A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
Last updated -
95
Python
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

Notion API Server

Reference video

How to install

How to set up

API Features

Search API

Database API

Page API

Block API

User API

Comment API

Cursor MCP Integration

Usage examples

Example search request

Page creation example

Example of creating a database

API Documentation

Related MCP Servers

Notion MCP Server

Notion MCP Server

Notion MCP Server

notion-mcp-server

New MCP Servers

MCP directory API