Сервер Notion MCP

API-сервер Notion

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

Видео о том, как использовать Notion MCP

Пользовательский сервер для простого использования 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

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Пользовательский сервер, предоставляющий интерфейс 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,230
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
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
194
91
TypeScript
MIT License
Notion MCP Serverofficial
makenotion
A
security
A
license
A
quality
An MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.
Last updated -
19
8,017
2,292
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 Serverofficial

New MCP Servers

MCP directory API