Сервер Notion MCP

Сервер, который подключается к API Notion и предоставляет функциональные возможности через протокол контекста машины Клода (MCP).

Функции

Поиск страниц Notion по названию или содержанию
Получить сведения о странице и ее содержимое
Запросить базу данных Notion
Создавайте новые страницы в Notion

Настраивать

Клонируйте этот репозиторий:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

Установить зависимости:

npm install

Создайте в корневом каталоге файл .env со следующим содержимым:

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

Получите свой ключ API Notion:
- Перейдите по ссылке https://www.notion.so/my-integrations
- Создать новую интеграцию
- Скопируйте «Токен внутренней интеграции»
- Добавьте этот токен как NOTION_API_KEY в файл .env
Подключите интеграцию Notion к своему рабочему пространству:
- Перейдите на страницу или в базу данных в вашем рабочем пространстве Notion.
- Нажмите на меню «...» в правом верхнем углу.
- Выберите «Добавить соединения».
- Найдите и добавьте свою интеграцию

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

Запустите сервер в режиме разработки:

npm run dev

Или в производственном режиме:

npm start

Сервер будет работать на порту, указанном в файле .env (по умолчанию: 3000).

Конечные точки API

Обычные конечные точки HTTP

POST /api/понятие/поиск
- Поиск страниц в Notion
- Тело: { "query": "search term" }
POST /api/понятие/страница
- Получить страницу по ID
- Тело: { "page_id": "page-id-here" }
POST /api/notion/база данных/запрос
- Запрос к базе данных
- Тело: { "database_id": "database-id-here", "filter": {}, "sorts": [] }
POST /api/notion/страница/создать
- Создать новую страницу
- Тело: { "parent": {}, "properties": {}, "children": [] }

Интеграция МКП

Сервер предоставляет манифест MCP в /mcp/manifest.json , в котором описываются доступные функции.

Чтобы вызвать функцию MCP, отправьте запрос POST на /api/notion/mcp/invoke со следующей структурой:

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

Доступные функции MCP

search_pages - Поиск страниц Notion по названию или содержанию
get_page — Получить страницу Notion по идентификатору
query_database — запрос к базе данных Notion
create_page — Создать новую страницу в Notion

Лицензия

Массачусетский технологический институт

Notion MCP Server