notion-mcp-server

notion-mcp-server — официальный MCP-сервер от makenotion. Официальный сервер Notion для работы со страницами и базами данных; для лучшей работы Notion советует удалённую версию. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
makenotion
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

Создаёт и меняет страницы и базы Notion, доступные интеграции. Репозиторий больше активно не поддерживается.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"notionApi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@notionhq/notion-mcp-server\"],\n      \"env\": {\n        \"NOTION_TOKEN\": \"ntn_****\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README (общий конфиг для Cursor и Claude Desktop)",
    "verified": "docs"
}

Что умеет

Notion MCP Server — локальный MCP-сервер от Notion, построенный на основе Notion API. Через него ИИ-ассистент ищет страницы, читает и редактирует их содержимое, работает с базами данных и оставляет комментарии.

Важно: авторы предупреждают, что этот репозиторий больше активно не поддерживается, и советуют использовать официальный облачный сервер Remote Notion MCP. Облачная версия работает через OAuth и учитывает права каждого пользователя, а у локальной — поиск только по ключевым словам и ручная настройка токена.

Основное:

  • Страницы в Markdown: retrieve-page-markdown читает страницу целиком в Markdown, а update-page-markdown правит её — заменяет всё содержимое (replace_content) или точечно находит и заменяет фрагменты (update_content).
  • Источники данных (базы) по API версии 2.0: запросы с фильтрами и сортировкой (query-data-source), схема (retrieve-a-data-source), создание и изменение, список шаблонов.
  • Перемещение страниц к другому родителю (move-page), комментарии и поиск.
  • Ограниченный набор действий: например, удалить базу данных через сервер нельзя.
  • Два транспорта: stdio по умолчанию и Streamable HTTP с обязательной авторизацией по bearer-токену.

Кому подойдёт

  • Тем, кто ведёт заметки и задачи в Notion: поиск, чтение и правка страниц через ассистента.
  • Командам, которым нужен свой сервер: развёртывание на своей инфраструктуре, в том числе для нескольких интеграций сразу.
  • Разработчикам, которые хотят разобраться, как MCP-сервер строится поверх OpenAPI.

Похожие серверы — в категории продуктивность.

Установка

  1. Создайте внутреннюю интеграцию на странице интеграций в профиле Notion. Для работы только на чтение оставьте в возможностях интеграции один пункт «Read content».
  2. Откройте интеграции доступ к нужным страницам и базам — на вкладке Access или через меню страницы «Connect to integration».
  3. Добавьте конфиг в клиент. Токен интеграции передаётся в переменной NOTION_TOKEN.

Сервер запускается через npx @notionhq/notion-mcp-server, есть и образ Docker mcp/notion. В режиме HTTP (--transport http) сервер слушает порт 3000 и адрес 127.0.0.1; токен доступа задаётся параметром --auth-token или переменной AUTH_TOKEN.

Подключение к клиентам

Конфиги приведены дословно из README. Для Cursor и Claude Desktop используется один и тот же блок. Общий порядок — в инструкции как подключить MCP.

.cursor/mcp.json
{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Проверка

Попросите ассистента найти страницу, к которой у интеграции есть доступ, и показать её содержимое.

Примеры задач

Оставь комментарий «Hello MCP» на странице «Getting started».
Добавь страницу «Notion MCP» внутрь страницы «Development».

Риски

Авторы прямо пишут: открывать данные рабочего пространства языковой модели — ненулевой риск. Сервер может создавать и менять страницы и базы, к которым есть доступ у интеграции. Флаг --unsafe-disable-auth отключает авторизацию HTTP-режима; тогда, по словам авторов, сервер может стать доступен посещаемым вами сайтам через DNS rebinding.

Как снизить риски: открывайте интеграции доступ только к нужным страницам, для чтения создайте интеграцию с одним правом «Read content», не отключайте авторизацию HTTP-режима. Многопользовательский режим с передачей токенов разворачивайте только через TLS. Лицензия — MIT.

Частые вопросы

Поддерживается ли этот сервер?

Нет. Авторы пишут, что репозиторий больше активно не поддерживается, и рекомендуют облачный Remote Notion MCP.

Почему ассистент не видит мои страницы?

Интеграции нужно явно открыть доступ к страницам и базам — на вкладке Access или через «Connect to integration».

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники