Сервер Notion MCP

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.

API-сервер Notion

Видео-справочник

Пользовательский сервер для простого использования Notion API. Он реализован с использованием Express.js и представляет различные функции Notion API как REST API.

Как установить

Установите необходимые пакеты:

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

Запуск сервера:

node server.js

Сервер работает по адресу http://localhost:3000 .

Как настроить

Установите свой токен API Notion в переменной NOTION_TOKEN в файле server.js:

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

При необходимости вы можете запустить его на другом порту, изменив переменную PORT.

Возможности API

API поиска

POST /api/search : Поиск страниц и баз данных в вашем рабочем пространстве Notion.

API базы данных

POST /api/databases : Создать базу данных
GET /api/databases/:id : Запрос к базе данных
PATCH /api/databases/:id Обновление базы данных
POST /api/databases/:id/query : Запрос к базе данных

API страницы

POST /api/pages : Создать страницу
GET /api/pages/:id : Просмотр информации о странице
PATCH /api/pages/:id : Обновление страницы
GET /api/pages/:page_id/properties/:property_id : Просмотр свойств страницы

API-интерфейс блока

GET /api/blocks/:id : Запрос блока
GET /api/blocks/:id/children : Просмотр содержимого блока
PATCH /api/blocks/:id : Обновление блока
PATCH /api/blocks/:id/children : Добавить содержимое блока
DELETE /api/blocks/:id : Удалить блок

Пользовательский API

GET /api/users : Просмотр списка пользователей
GET /api/users/:id : Поиск пользователя
GET /api/users/me : Просмотр информации о вашем пользователе

API комментариев

POST /api/comments : Создать комментарий
GET /api/comments?block_id=... : Просмотреть комментарии

Интеграция курсора MCP

Добавьте следующие настройки в файл .cursor/mcp.json :

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

Вы можете получить доступ к API Notion с помощью функций MCP в Cursor во время работы сервера.

Примеры использования

Пример поискового запроса

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

Пример создания страницы

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

Пример создания базы данных

// 데이터베이스 생성
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-документация

Документация по API доступна по следующему URL-адресу при запуске сервера:

Пользовательский интерфейс Swagger: http://localhost:3000/api-docs
Схема OpenAPI: http://localhost:3000/openapi.json

This server cannot be installed

security - not tested

license - not found

quality - not tested

Пользовательский сервер, предоставляющий интерфейс REST API для Notion, позволяющий легко получить доступ к функциональным возможностям Notion через функцию MCP Cursor.

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

API-сервер Notion

Видео-справочник

Как установить

Как настроить

Возможности API

API поиска

API базы данных

API страницы

API-интерфейс блока

Пользовательский API

API комментариев

Интеграция курсора MCP

Примеры использования

Пример поискового запроса

Пример создания страницы

Пример создания базы данных

API-документация

Related MCP Servers

Notion MCP Server

Notion MCP Server

Notion MCP Server

notion-mcp-server

New MCP Servers

MCP directory API