Notion MCP Server

Сервер для интеграции Notion, предоставляющий стандартизированный интерфейс для работы с API Notion: базы данных, страницы и поиск.

Python

⭐ 109 stars

Описание

Реализация сервера для Notion на базе протокола MCP, совместимая с Claude Desktop. Ключевые особенности: перечисление и запрос баз данных, создание/обновление страниц, поиск по workspace, получение деталей баз и блоков. Использует Python с httpx для асинхронных запросов, Pydantic v2 для типобезопасности, детальное логирование ошибок. Применения: автоматизация задач в Notion через AI-клиенты, интеграция с инструментами вроде Claude для управления контентом.

Возможности

✓

Перечисление и запрос баз данных Notion

Список баз и выполнение запросов для фильтрации и извлечения данных.

✓

Создание и обновление страниц

Генерация новых страниц и редактирование существующих в Notion.

✓

Поиск по workspace

Глобальный поиск контента по всему рабочему пространству Notion.

✓

Получение деталей баз и блоков

Извлечение информации о базах данных и дочерних блоках страниц.

✓

Асинхронная поддержка с httpx

Эффективная работа с API Notion через async/await для высокой производительности.

✓

Типобезопасность с Pydantic v2

Модели для валидации и типизации объектов Notion.

Установка

Установка вручную: 1. Клонировать репозиторий: git clone https://github.com/ccabanillas/notion-mcp.git && cd notion-mcp. 2. Создать виртуальное окружение: uv venv && source .venv/bin/activate (или python -m venv venv && source venv/bin/activate), затем uv pip install -e . (или pip install -e .). 3. Создать .env с NOTION_API_KEY=your_notion_integration_token. Для Claude Desktop настроить claude_desktop_config.json: {“servers”: {“notion-mcp”: {“command”: “/path/to/python”, “args”: ["-m", “notion_mcp”], “cwd”: “/path/to/notion-mcp”}}}. Через Smithery: npx -y @smithery/cli install @ccabanillas/notion-mcp –client claude. Требует токен Notion из https://www.notion.so/my-integrations и доступ к базам.

Информация

Язык

Python

Лицензия

MIT License

GitHub Stars

109

Ссылки

GitHub