notion-mcp-server
notion-mcp-server — официальный MCP-сервер от makenotion. Официальный сервер Notion для работы со страницами и базами данных; для лучшей работы Notion советует удалённую версию. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- makenotion
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Создаёт и меняет страницы и базы Notion, доступные интеграции. Репозиторий больше активно не поддерживается.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"notionApi\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@notionhq/notion-mcp-server\"],\n \"env\": {\n \"NOTION_TOKEN\": \"ntn_****\"\n }\n }\n }\n}",
"file": ".cursor/mcp.json",
"lang": "json",
"notes": "Дословно из README (общий конфиг для Cursor и Claude Desktop)",
"verified": "docs"
}
Что умеет
Notion MCP Server — локальный MCP-сервер от Notion, построенный на основе Notion API. Через него ИИ-ассистент ищет страницы, читает и редактирует их содержимое, работает с базами данных и оставляет комментарии.
Важно: авторы предупреждают, что этот репозиторий больше активно не поддерживается, и советуют использовать официальный облачный сервер Remote Notion MCP. Облачная версия работает через OAuth и учитывает права каждого пользователя, а у локальной — поиск только по ключевым словам и ручная настройка токена.
Основное:
- Страницы в Markdown:
retrieve-page-markdownчитает страницу целиком в Markdown, аupdate-page-markdownправит её — заменяет всё содержимое (replace_content) или точечно находит и заменяет фрагменты (update_content). - Источники данных (базы) по API версии 2.0: запросы с фильтрами и сортировкой (
query-data-source), схема (retrieve-a-data-source), создание и изменение, список шаблонов. - Перемещение страниц к другому родителю (
move-page), комментарии и поиск. - Ограниченный набор действий: например, удалить базу данных через сервер нельзя.
- Два транспорта: stdio по умолчанию и Streamable HTTP с обязательной авторизацией по bearer-токену.
Кому подойдёт
- Тем, кто ведёт заметки и задачи в Notion: поиск, чтение и правка страниц через ассистента.
- Командам, которым нужен свой сервер: развёртывание на своей инфраструктуре, в том числе для нескольких интеграций сразу.
- Разработчикам, которые хотят разобраться, как MCP-сервер строится поверх OpenAPI.
Похожие серверы — в категории продуктивность.
Установка
- Создайте внутреннюю интеграцию на странице интеграций в профиле Notion. Для работы только на чтение оставьте в возможностях интеграции один пункт «Read content».
- Откройте интеграции доступ к нужным страницам и базам — на вкладке Access или через меню страницы «Connect to integration».
- Добавьте конфиг в клиент. Токен интеграции передаётся в переменной
NOTION_TOKEN.
Сервер запускается через npx @notionhq/notion-mcp-server, есть и образ Docker mcp/notion. В режиме HTTP (--transport http) сервер слушает порт 3000 и адрес 127.0.0.1; токен доступа задаётся параметром --auth-token или переменной AUTH_TOKEN.
Подключение к клиентам
Конфиги приведены дословно из README. Для Cursor и Claude Desktop используется один и тот же блок. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_****"
}
}
}
}Проверка
Попросите ассистента найти страницу, к которой у интеграции есть доступ, и показать её содержимое.
Примеры задач
Оставь комментарий «Hello MCP» на странице «Getting started».Добавь страницу «Notion MCP» внутрь страницы «Development».Риски
Авторы прямо пишут: открывать данные рабочего пространства языковой модели — ненулевой риск. Сервер может создавать и менять страницы и базы, к которым есть доступ у интеграции. Флаг --unsafe-disable-auth отключает авторизацию HTTP-режима; тогда, по словам авторов, сервер может стать доступен посещаемым вами сайтам через DNS rebinding.
Как снизить риски: открывайте интеграции доступ только к нужным страницам, для чтения создайте интеграцию с одним правом «Read content», не отключайте авторизацию HTTP-режима. Многопользовательский режим с передачей токенов разворачивайте только через TLS. Лицензия — MIT.
Частые вопросы
Поддерживается ли этот сервер?
Нет. Авторы пишут, что репозиторий больше активно не поддерживается, и рекомендуют облачный Remote Notion MCP.
Почему ассистент не видит мои страницы?
Интеграции нужно явно открыть доступ к страницам и базам — на вкладке Access или через «Connect to integration».
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.