easy-notion-mcp

easy-notion-mcp — MCP-сервер сообщества (автор — Grey-Iris). Сервер Notion на основе Markdown с экономией токенов. Ставится через npx. Лицензия MIT.

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

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

Разработчик
Grey-Iris
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
linux, macos, windows
Языки
typescript

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

Создаёт, меняет и архивирует страницы и базы Notion; читает локальные файлы для загрузки.

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

vscode
{
    "code": "{\n  \"servers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"easy-notion-mcp\"],\n      \"env\": {\n        \"NOTION_TOKEN\": \"ntn_your_integration_token\"\n      }\n    }\n  }\n}",
    "file": ".vscode/mcp.json",
    "lang": "json",
    "verified": "docs"
}

Что умеет

Easy Notion MCP — MCP-сервер для Notion, построенный вокруг Markdown. Агент пишет обычный Markdown, а сервер переводит его в блочный API Notion и обратно. Итог: 43 инструмента, 24 типа блоков и, по замерам авторов, в 6–7 раз меньше токенов в ответах, чем у официального npm-сервера Notion.

Почему меньше токенов. Официальный сервер возвращает сырой JSON Notion, где у каждого блока есть идентификаторы, отметки времени и объекты авторов — агенту, который читает содержимое, это не нужно. Обычно экономия 5–7 раз: около 3 раз на страницах с кодом и до 15 раз на насыщенных страницах. Выигрыш — в отбрасывании метаданных, а не в более плотной кодировке.

Сравнение: стандартный Markdown (GFM) вместо сырого JSON; 24 типа блоков с документированным обратным преобразованием (переключатели, колонки, выноски, формулы, встраивания, таблицы, файлы, списки задач); загрузка файлов через ссылки file:/// в Markdown; защита от промпт-инъекций; записи баз данных в виде простых пар ключ-значение.

Инструменты по группам:

  • Страницы (20): создание из Markdown или из локального файла, чтение страницы, раздела, блока или переключателя, поиск по тексту, дописывание, атомарная замена содержимого, обновление раздела, поиск с заменой, обновление блока, дублирование, перемещение, архивирование и восстановление. Разрушительные инструменты поддерживают предварительный прогон dry_run.
  • Навигация (3): список дочерних страниц с датами создания и правки, поиск, ссылка для доступа.
  • Базы данных (9): создание со схемой, изменение схемы, запросы с фильтрами и сортировкой, добавление записей по одной и пачкой, обновление и удаление записей. Неизвестные свойства отклоняются с понятной ошибкой.
  • Представления (6): таблица, список, доска, календарь, галерея, хронология.
  • Комментарии (2), пользователи (2), служебный get_config (1).

Пакетное добавление возвращает отдельные списки успешных и неудачных записей, так что повторять можно только ошибки.

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

Тем, кто ведёт заметки, задачи и базы в Notion и хочет, чтобы агент создавал и правил страницы, не тратя токены на служебный JSON. Похожие серверы — в категории продуктивность.

Установка

Создайте интеграцию Notion, скопируйте токен и откройте ей доступ к нужным страницам. Сервер запускается через npx -y easy-notion-mcp с переменной NOTION_TOKEN; страницу-родителя по умолчанию для create_page задаёт NOTION_ROOT_PAGE_ID. Есть и HTTP-режим с OAuth: npx -p easy-notion-mcp easy-notion-mcp-http с переменными NOTION_OAUTH_CLIENT_ID и NOTION_OAUTH_CLIENT_SECRET.

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

Конфиги приведены дословно из README; подставьте свой токен. Подробнее — в инструкции как подключить MCP.

claude mcp add notion -s user \
  -e NOTION_TOKEN=ntn_your_integration_token \
  -- npx -y easy-notion-mcp

Тот же JSON, что для Claude Desktop, подходит для Cursor (.cursor/mcp.json) и Windsurf. Для VS Code файл — .vscode/mcp.json, ключ верхнего уровня — servers. В Claude Code токен хранится в конфиге, привязанном к этому серверу.

Проверка

Спросите агента: «Какие базы данных Notion тебе доступны?»

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

Преврати заметки со встречи в задачи в базе «Задачи» со статусом «К работе».
Замени во всех разделах страницы «Q3» на «Q4», сохранив файлы.

Риски

  • Запись в рабочее пространство Notion. Агент создаёт, меняет, перемещает и архивирует страницы, меняет схемы баз и удаляет представления. Используйте dry_run и дублируйте важные страницы перед правкой.
  • Токен интеграции видит только страницы, к которым вы открыли доступ.
  • Чтение локальных файлов для загрузки через file:/// и create_page_from_file (только внутри корня рабочего каталога).
  • Ответы на чтение помечаются как содержимое, а не инструкции, а небезопасные протоколы ссылок вырезаются.

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

Чем лучше официального сервера?

Markdown вместо сырого JSON и в 6–7 раз меньше токенов.

Поддерживается ли загрузка файлов?

Да, через ссылки file:/// в Markdown.

Есть ли OAuth?

Да, в HTTP-режиме.

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

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

CodeBurn

Учёт расходов, токенов и квот ИИ-инструментов программирования, включая Claude Code и Cursor.

Риск: medium Лицензия: MIT ★ 11 762

google_workspace_mcp

Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.

Риск: medium Лицензия: MIT ★ 3 495

RevoGrid DataGrid MCP

Справка по RevoGrid DataGrid для агентов.

Риск: medium Лицензия: MIT ★ 3 455

kordoc

Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.

Риск: medium Лицензия: MIT ★ 2 938

Источники