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.
DevelopmentProductivityNotion
Открыть на GitHub

Установка

npx -y @n24q02m/better-notion-mcp

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться