easy-notion

easy-notion

Grey-IrisMIT
28 звёзд7 форков
Easy Notion — MCP-сервер для интеграции AI-агентов с Notion. Агенты пишут на Markdown, а сервер автоматически преобразует команды в вызовы Notion API и обратно. Это полностью решает проблему несовместимости форматов и лишнего расхода токенов. Сервер построен на Markdown-first подходе. Любая страница Notion читается и записывается как Markdown-документ. При повторном открытии форматирование сохраняется на 100 % — round-trip fidelity. В набор входят 42 инструмента для всех сценариев: от простого чтения до сложной работы с базами данных.

Установка

npx -y easy-notion-mcp

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

Общее

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

Технологии

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

Описание

Возможности

  • В набор входят 42 инструмента: чтение, создание, редактирование, удаление страниц и блоков
  • Поддерживает 24 типа блоков: заголовки, списки, код, изображения, таблицы и другие
  • Читает любые страницы и отдаёт их в чистом Markdown с сохранением структуры
  • Создаёт и редактирует страницы через Markdown-синтаксис
  • Гарантирует сохранение форматирования при повторном редактировании — round-trip fidelity
  • Работает с базами данных: создаёт записи, фильтрует, сортирует, ищет
  • Ищет по всему рабочему пространству Notion
  • Обрабатывает вложения, ссылки и вложенные страницы

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

1. Запустите сервер через npx. Глобальная установка не требуется: npx -y easy-notion-mcp

2. Создайте внутреннюю интеграцию в настройках Notion. Скопируйте токен доступа (Internal Integration Secret).

3. Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop (файл claude_desktop_config.json):

{ "mcpServers": { "easy-notion": { "command": "npx", "args": ["-y", "easy-notion-mcp"], "env": { "NOTION_TOKEN": "ваш_секретный_токен" } } } }

4. Предоставьте интеграции доступ к нужным страницам Notion (через меню «Подключения» на странице).

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

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

«Создай в Notion страницу «Roadmap Q3». Оформи её заголовками H1, H2, добавь маркированный список задач и чекбоксы в Markdown.»

«Найди в базе данных «Клиенты» все записи со статусом «Новый» за последние 7 дней и выведи названия компаний и контактные лица.»

«Прочитай страницу «Политика конфиденциальности» и преврати её в Markdown. Сохрани все ссылки и вложенные списки.»

«Добавь в базу «Кандидаты» новую запись: имя — Анна Смирнова, должность — DevOps Engineer, статус — Скрининг, зарплатная вилка — 3000-4000 USD.»

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

Разработчик: Grey-Iris
Язык: TypeScript
Транспорт: stdio
Лицензия: MIT
Звёзды GitHub: 28
Установка: npx -y easy-notion-mcp
Совместимость: Любые MCP-клиенты (Claude Desktop, Cline, Continue, VS Code, AWS Bedrock)

Поделиться