mcp-notion-server

mcp-notion-server — MCP-сервер сообщества (автор — suekou). Работа с Notion через API: страницы, базы и блоки. Лицензия MIT.

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

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

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

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

С правами вставки и обновления создаёт и меняет страницы и базы Notion в пределах выданного доступа.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@suekou/mcp-notion-server\"],\n      \"env\": {\n        \"NOTION_API_TOKEN\": \"secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Notion MCP Server — MCP-сервер для Notion API, удобный для ИИ-агентов. Он помогает находить, читать, запрашивать и обновлять рабочие пространства Notion и при этом держит ответы компактными. Сервер работает с Notion API версии 2026-03-11 и актуальной моделью баз данных и источников данных (data sources). Он даёт MCP-инструменты, промпты, ресурсы, структурированные результаты и необязательные MCP Apps.

Основные возможности:

  • Поиск страниц и источников данных — notion_find.
  • Компактное чтение страниц со стабильными ID блоков — notion_read_page.
  • Схема источника данных — notion_inspect_data_source.
  • Запросы и создание записей по простым значениям с учётом схемы — notion_query_data_source_by_values и notion_create_data_source_item_from_values.
  • Простое редактирование страниц — абзацы, заголовки, списки, задачи, цитаты, выноски, блоки кода, разделители и безопасное добавление Markdown (notion_append_markdown, notion_append_content, notion_update_content, notion_update_content_batch).
  • Низкоуровневые инструменты Notion API — для блоков, страниц, баз, источников данных, комментариев и пользователей.
  • MCP Apps — интерактивные Data Source Explorer и Page Workbench.

Порядок работы, который советуют авторы: найти цель через notion_find, прочитать страницу, изучить схему перед запросом, затем вносить правки упрощёнными инструментами. К низкоуровневым JSON-инструментам стоит переходить, только если упрощённых не хватает.

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

  • Тем, кто ведёт базу знаний и задачи в Notion: поиск, сводки и обновление страниц из чата.
  • Менеджерам проектов: запросы к базам задач и создание записей по простым значениям.
  • Разработчикам: автоматизация Notion через агента без ручной работы с JSON блоков.

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

Установка

  1. Создайте внутреннюю интеграцию в панели интеграций Notion.
  2. Выдайте ей только нужные права: чтение контента обязательно; вставка и обновление — для правок; комментарии и данные пользователей — только если вам нужны эти инструменты.
  3. На вкладке Content access выберите страницы и базы, к которым будет доступ. Добавить интеграцию можно и через меню «...» → Connections на самой странице — тогда доступ получат и её дочерние страницы.
  4. Скопируйте секрет интеграции — это значение для NOTION_API_TOKEN.

Сервер запускается командой npx -y @suekou/mcp-notion-server, нужен Node.js.

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

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

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

После сохранения конфига перезапустите MCP-клиент. Для локальной сборки укажите node и путь к build/index.js.

Проверка

Попросите агента найти в Notion страницу по названию — сработает notion_find. Затем попросите прочитать её через notion_read_page.

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

Найди в Notion базу задач и покажи все задачи со статусом «В работе».
Добавь в страницу «Итоги встречи» список решений и задачу на следующую неделю.

Риски

С правами на вставку и обновление агент создаёт и меняет страницы, записи и схемы баз, а низкоуровневые инструменты дают почти полный доступ к Notion API в пределах выданных страниц. Меры защиты: выдавайте интеграции минимальные права и подключайте только нужные страницы. Notion сам ограничивает интеграцию страницами, которыми с ней поделились. Токен интеграции — секрет: храните его в конфиге клиента или переменных окружения и не коммитьте. Содержимое страниц — недоверенные данные, в нём могут быть инструкции для агента.

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

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

Интеграции нужно дать доступ: на вкладке Content access или через меню страницы «...» → Connections.

Можно ли дать только чтение?

Да. Включите у интеграции только право Read content — инструменты записи тогда не сработают.

Основы протокола — на странице что такое 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

Источники