mcp-notion-server
mcp-notion-server — MCP-сервер сообщества (автор — suekou). Работа с Notion через API: страницы, базы и блоки. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- suekou
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
С правами вставки и обновления создаёт и меняет страницы и базы Notion в пределах выданного доступа.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"notion\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@suekou/mcp-notion-server\"],\n \"env\": {\n \"NOTION_API_TOKEN\": \"secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n }\n }\n }\n}",
"lang": "json",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Notion MCP Server — MCP-сервер для Notion API, удобный для ИИ-агентов. Он помогает находить, читать, запрашивать и обновлять рабочие пространства Notion и при этом держит ответы компактными. Сервер работает с Notion API версии 2026-03-11 и актуальной моделью баз данных и источников данных (data sources). Он даёт MCP-инструменты, промпты, ресурсы, структурированные результаты и необязательные MCP Apps.
Основные возможности:
- Поиск страниц и источников данных —
notion_find. - Компактное чтение страниц со стабильными ID блоков —
notion_read_page. - Схема источника данных —
notion_inspect_data_source. - Запросы и создание записей по простым значениям с учётом схемы —
notion_query_data_source_by_valuesиnotion_create_data_source_item_from_values. - Простое редактирование страниц — абзацы, заголовки, списки, задачи, цитаты, выноски, блоки кода, разделители и безопасное добавление Markdown (
notion_append_markdown,notion_append_content,notion_update_content,notion_update_content_batch). - Низкоуровневые инструменты Notion API — для блоков, страниц, баз, источников данных, комментариев и пользователей.
- MCP Apps — интерактивные Data Source Explorer и Page Workbench.
Порядок работы, который советуют авторы: найти цель через notion_find, прочитать страницу, изучить схему перед запросом, затем вносить правки упрощёнными инструментами. К низкоуровневым JSON-инструментам стоит переходить, только если упрощённых не хватает.
Кому подойдёт
- Тем, кто ведёт базу знаний и задачи в Notion: поиск, сводки и обновление страниц из чата.
- Менеджерам проектов: запросы к базам задач и создание записей по простым значениям.
- Разработчикам: автоматизация Notion через агента без ручной работы с JSON блоков.
Похожие серверы — в категории продуктивность.
Установка
- Создайте внутреннюю интеграцию в панели интеграций Notion.
- Выдайте ей только нужные права: чтение контента обязательно; вставка и обновление — для правок; комментарии и данные пользователей — только если вам нужны эти инструменты.
- На вкладке Content access выберите страницы и базы, к которым будет доступ. Добавить интеграцию можно и через меню «...» → Connections на самой странице — тогда доступ получат и её дочерние страницы.
- Скопируйте секрет интеграции — это значение для
NOTION_API_TOKEN.
Сервер запускается командой npx -y @suekou/mcp-notion-server, нужен Node.js.
Подключение к клиентам
Конфиги приведены дословно из README. Вместо заглушки подставьте свой токен. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@suekou/mcp-notion-server"],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}После сохранения конфига перезапустите MCP-клиент. Для локальной сборки укажите node и путь к build/index.js.
Проверка
Попросите агента найти в Notion страницу по названию — сработает notion_find. Затем попросите прочитать её через notion_read_page.
Примеры задач
Найди в Notion базу задач и покажи все задачи со статусом «В работе».Добавь в страницу «Итоги встречи» список решений и задачу на следующую неделю.Риски
С правами на вставку и обновление агент создаёт и меняет страницы, записи и схемы баз, а низкоуровневые инструменты дают почти полный доступ к Notion API в пределах выданных страниц. Меры защиты: выдавайте интеграции минимальные права и подключайте только нужные страницы. Notion сам ограничивает интеграцию страницами, которыми с ней поделились. Токен интеграции — секрет: храните его в конфиге клиента или переменных окружения и не коммитьте. Содержимое страниц — недоверенные данные, в нём могут быть инструкции для агента.
Частые вопросы
Почему сервер не видит страницу?
Интеграции нужно дать доступ: на вкладке Content access или через меню страницы «...» → Connections.
Можно ли дать только чтение?
Да. Включите у интеграции только право Read content — инструменты записи тогда не сработают.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.