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; читает локальные файлы для загрузки.
Настройка клиентов
{
"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.
google_workspace_mcp
Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.
RevoGrid DataGrid MCP
Справка по RevoGrid DataGrid для агентов.
kordoc
Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.