Better Notion MCP

Better Notion MCP

n24q02mMIT
31 звёзд11 форков
Better Notion MCP — сервер для AI-агентов, который делает работу с Notion через языковые модели простой и эффективной. Вместо того чтобы писать десятки мелких API-запросов, AI-агент использует 10 мощных составных инструментов. Они заменяют 28+ прямых вызовов Notion API. Всё взаимодействие строится на Markdown: вы или агент описываете задачу Markdown-разметкой, сервер сам разбирает её, выполняет нужные запросы к API Notion и возвращает результат. Это подходит для автоматизации рутины, ведения документации, управления проектами и интеграции Notion с другими сервисами через MCP.
РазработкаПродуктивностьNotion
Подключить MCPОткрыть на GitHub
Подключение

Подключить Better Notion MCP

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude

Hosted Notion MCP server with OAuth.

  1. 1.Получите endpoint и токен доступа, если он требуется.
  2. 2.Добавьте remote MCP endpoint в Claude.
  3. 3.Проверьте подключение в списке доступных инструментов.
json
{
  "mcpServers": {
    "better-notion-mcp": {
      "url": "https://mcp.notion.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Legacy SSE endpoint is https://mcp.notion.com/sse.

Official docs recommend hosted Notion MCP over the older open-source package.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Better Notion MCP

Better Notion MCP относится к Разработка, Продуктивность, Notion. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
TypeScript
Транспорт
streamable-http, stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

  • СтатусСообщество
  • Разработчикn24q02m
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    streamable-httpstdio

Описание

Возможности

  • Создаёт страницы из Markdown: заголовки, списки, таблицы, изображения — всё преобразуется в блоки Notion за один вызов
  • Читает страницы и базы данных в Markdown-формате, готовом для вставки в контекст AI-агента
  • Редактирует и дополняет существующие блоки: меняет текст, структуру, добавляет вложения
  • Ищет по рабочему пространству с фильтрацией по тексту, статусу, дате, пользователю
  • Управляет базами данных: создаёт записи, настраивает свойства, сортирует и выбирает данные
  • Работает с комментариями: создаёт, читает, отвечает, удаляет обсуждения на страницах
  • Экспортирует контент в Markdown для передачи в другие MCP-серверы или внешние системы
  • Выполняет массовые операции: одно действие заменяет цепочку из 2–5 обычных API-запросов
  • Поддерживает работу с формулами и relation-полями в базах данных Notion
  • Автоматически преобразует Markdown-разметку в структурированные блоки Notion: заголовки разных уровней, списки, код, цитаты, таблицы

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

Для работы потребуется API-ключ Notion. Создайте интеграцию в Notion Integration Settings, добавьте её к нужным страницам и скопируйте ключ. Подробнее — в документации Notion.

  1. Установите сервер через npx:
    npx -y @n24q02m/better-notion-mcp
  2. Пропишите конфигурацию в вашем MCP-клиенте. Пример для Claude Desktop:
    { "mcpServers": { "notion": { "command": "npx", "args": ["-y", "@n24q02m/better-notion-mcp"], "env": { "NOTION_API_KEY": "ваш API-ключ Notion" } } } }
  3. Перезапустите клиент. Сервер начнёт работу автоматически.

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

  • «Создай страницу в разделе «Идеи» с заголовком «A/B-тестирование лендинга» и добавь теги #маркетинг #тесты»
  • «Найди все страницы в базе «Проекты», где дата дедлайна раньше завтрашнего дня, и покажи их списком»
  • «Обнови статус задачи «Согласовать макет» на «Готово» в базе «Дизайн-спринт» и добавь комментарий»
  • «Покажи последние 5 комментариев к странице «Ретроспектива спринта» в Markdown-формате»

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

  • Язык: TypeScript
  • Среда выполнения: Node.js
  • Транспорт: Stdio, Streamable HTTP
  • Лицензия: MIT
  • Совместимость: Claude Desktop, MCP Inspector, VS Code через расширение MCP, Continue.dev, любые MCP-хосты
  • Пакет: @n24q02m/better-notion-mcp
  • Разработчик: n24q02m

Поделиться