better-notion

better-notion

ai-aviateNOASSERTION
2 звёзд
Типичные MCP-серверы для Notion работают как тонкая обёртка над API. Чтобы ассистент создал запись в базе данных, ему приходится делать несколько последовательных вызовов: поиск базы, получение схемы, создание страницы, добавление блоков. Это раздувает контекст и замедляет ответы. better-notion решает эту проблему иначе. Вы и AI-ассистент работаете с Notion через один Markdown-документ. У него есть YAML-заголовок с метаданными (свойства страницы) и тело в формате Markdown (содержимое). Одна команда — одно действие, без лишних запросов к API. Вместо десятков мелких инструментов сервер использует 9 целостных операций. Это быстрее, проще для понимания и легче для контекста. Сервер будет полезен разработчикам и продвинутым пользователям Notion, которые хотят автоматизировать работу с базой знаний: создавать карточки, вести документацию, управлять задачами — всё через одного AI-ассистента.
Ai-mlProductivityFilesNotion
Открыть на GitHub

Установка

npx -y better-mcp-notion

Характеристики

Общее

  • СтатусСообщество
  • Разработчикai-aviate
  • ЛицензияNOASSERTION

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Читать страницу Notion как Markdown-документ с YAML frontmatter. Поддерживается рекурсивное чтение дочерних страниц (параметр depth).
  • Создавать и обновлять страницы из Markdown в один вызов. Есть пакетные операции и режимы append/prepend.
  • Искать по рабочему пространству Notion по ключевым словам. Результат отдаётся в виде форматированного Markdown-списка.
  • Выводить записи баз данных таблицей или дочерние страницы списком. Поддержка фильтрации и сортировки на естественном языке.
  • Обновлять значения свойств страницы (статус, теги, даты) без перезаписи содержимого.
  • Просматривать и редактировать схему базы данных: добавлять, удалять или переименовывать колонки.
  • Добавлять и читать комментарии на странице.
  • Архивировать (мягко удалять) страницы.
  • Перемещать страницы между разделами и базами данных.

Как подключить

Для работы сервера нужен API-ключ интеграции Notion и доступ к вашим страницам.

  1. Создайте интеграцию на странице профиля разработчика Notion: notion.so/profile/integrations. Скопируйте токен (начинается с ntn_).
  2. В самом Notion откройте страницы или базы данных, к которым сервер должен получить доступ. В меню «Connect to» выберите вашу интеграцию.
  3. Установите сервер командой: npx -y better-mcp-notion
  4. Добавьте конфигурацию в ваш MCP-клиент. Обязательна переменная окружения NOTION_API_KEY. Пример конфигурации для Claude Desktop, Cursor или Windsurf:
{ "mcpServers": { "better-notion": { "command": "npx", "args": ["-y", "better-mcp-notion"], "env": { "NOTION_API_KEY": "ваш_ntn_ключ" } } } }

Перезапустите клиент MCP. Сервер готов к работе.

Примеры запросов

  • «Найди все задачи из базы «Разработка» со статусом «В работе» и покажи их в виде таблицы.»
  • «Обнови статус страницы «Отчёт за январь» на «Готово» и поставь тег «Финансы».»
  • «Создай новую заметку в базе «Идеи» с заголовком «A/B тест» и содержимым: «Провести тест на главной странице».»
  • «Перемести страницу «Результаты опроса» в базу «Маркетинг».»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: не указана
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor, Windsurf и любые другие MCP-клиенты с поддержкой stdio.

Поделиться