notion-mcp

notion-mcp

shck-devMIT
1 звёзд
Notion MCP Server подключает AI-ассистента к вашему рабочему пространству Notion. Он ищет страницы по тексту, выгружает их в Markdown, заменяет или добавляет контент, создаёт новые страницы и работает с комментариями. Главное преимущество — отсутствие сложной настройки. Не нужен OAuth, права администратора или шаринг страниц. Сервер использует внутренний API Notion, который работает из браузера. Просто скопируйте CURL-запрос из вкладки Network — и сервер извлечёт учётные данные автоматически.

Установка

npx -y @shck-dev/notion-mcp

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

Общее

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

Технологии

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

Описание

Возможности

  • Полнотекстовый поиск по всему рабочему пространству: заголовки, текстовые блоки, теги, обсуждения.
  • Экспорт страниц в чистый Markdown с точным сохранением иерархии: заголовки, списки, чекбоксы, код, таблицы, ссылки, изображения с читаемыми URL.
  • Импорт Markdown из строки или локального файла с полной заменой содержимого целевой страницы.
  • Добавление Markdown-блоков в конец страницы без удаления существующего контента.
  • Создание дочерних страниц внутри баз данных или родительских страниц с начальным наполнением из Markdown.
  • Загрузка локальных изображений на страницу Notion или вставка ссылок на внешние изображения.
  • Просмотр открытых обсуждений, добавление новых комментариев и ответов в существующие треды.
  • Настройка одной командой: npx @shck-dev/notion-mcp init обработает CURL-запрос и сохранит .env.
  • Встроенный промпт notion_setup и ресурс notion://guide для знакомства с сервером прямо из интерфейса AI-клиента.

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

Установка и настройка занимают меньше минуты.

  1. Установите пакет: npx -y @shck-dev/notion-mcp
  2. Выполните настройку: npx @shck-dev/notion-mcp init. Сервер запросит CURL-запрос из браузера — вставьте его.
  3. Пропишите сервер в конфигурации клиента:
  4. {
      "mcpServers": {
        "notion": {
          "command": "npx",
          "args": ["-y", "@shck-dev/notion-mcp"]
        }
      }
    }
  5. Перезапустите клиент и проверьте подключение.

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

  • «Найди в моём Notion страницу по проекту «Марс-2024» и выгрузи её в Markdown.»
  • «Возьми содержимое файла report.md и обнови страницу «Еженедельный отчёт», заменив её контент.»
  • «Создай дочернюю страницу в базе «Задачи» с заголовком «Рефакторинг модуля оплаты» и прикрепи описание из файла task.md.»
  • «Покажи все открытые обсуждения на странице «Дизайн UI v2» и добавь комментарий к первому треду.»
  • «Добавь блок с изображением screenshot.png в конец страницы «Инструкция».»

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

  • Язык: TypeScript (сборка под Node.js)
  • Транспорт: stdio
  • Лицензия: MIT
  • Категории: Notion, поиск, продуктивность
  • Совместимость: Claude Desktop, Cursor, GitHub Copilot, любые MCP-клиенты

Поделиться