Notion MCP

makenotion/notion-mcp-server· Проверено 12.11.2026· 4,7 тыс.на GitHub

Локальный сервер Notion поверх Notion API: поиск по заголовкам, чтение и правка страниц в Markdown, базы и источники данных, блоки, комментарии и пользователи. Агент видит только страницы, открытые интеграции.

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

Что сделать до подключения

1

Node.js с npx

2

Внутренняя интеграция Notion и доступ к нужным страницам: вкладка Access в настройках интеграции или «⋯ → Connect to integration» на странице

3
NOTION_TOKEN

создайте внутреннюю интеграцию на notion.so/profile/integrations и скопируйте её токен ntn_…; для режима только чтения оставьте в Capabilities одну галочку Read content

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'NOTION_TOKEN=ntn_<токен интеграции>' --transport stdio notion \
  -- npx -y @notionhq/notion-mcp-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

API-post-searchищет страницы по заголовку
API-retrieve-page-markdownчитает страницу в Markdown
API-update-page-markdownправит страницу в Markdown
API-post-pageсоздаёт страницу
API-patch-pageменяет свойства страницы
API-move-pageпереносит страницу
API-retrieve-a-pageчитает свойства страницы
API-get-block-childrenчитает блоки страницы
API-patch-block-childrenдобавляет блоки
API-update-a-blockправит блок
API-delete-a-blockудаляет блок
API-query-data-sourceвыбирает записи базы с фильтрами
API-retrieve-a-data-sourceпоказывает схему базы
API-create-a-data-sourceсоздаёт базу
API-update-a-data-sourceменяет свойства базы
API-list-data-source-templatesперечисляет шаблоны базы
API-retrieve-a-commentчитает комментарии
API-create-a-commentоставляет комментарий
API-get-usersперечисляет пользователей

Показано 19 из 24.

Что попросить агента

«Оставь комментарий «<текст>» на странице «<название>»»Агент найдёт страницу через API-post-search и вызовет API-create-a-comment
«Добавь страницу «<заголовок>» в раздел «<родительская страница>» и напиши в ней <что написать>»Агент найдёт родителя через API-post-search, создаст страницу API-post-page и заполнит её API-update-page-markdown
«Покажи содержимое страницы <ID страницы>»Агент вызовет API-retrieve-page-markdown и вернёт текст в Markdown
«Выбери из базы «<название базы>» задачи со статусом <статус>, отсортируй по дате»Агент посмотрит схему через API-retrieve-a-data-source и сделает выборку API-query-data-source с фильтром и сортировкой

Для каких задач

Найти страницу по названию и пересказать её содержимое
Добавить страницу в нужный раздел и наполнить её текстом в Markdown
Точечно заменить фрагмент текста на странице
Выбрать записи базы по фильтру и сортировке
Оставить комментарий на странице

Ограничения

!

Notion больше не развивает и не поддерживает этот репозиторий и советует перейти на удалённый Remote Notion MCP

!

Поиск идёт только по ключевым словам в заголовках, без семантического поиска

!

Доступ выдаётся вручную: каждую страницу или базу нужно подключить к интеграции

!

Удалять базы через сервер нельзя, но правка и удаление блоков доступны; для защиты выдайте интеграции только чтение

Если не работает

Агент ищет инструмент post-database-query или create-a-database, а его нет
С версии 2.0.0 эти инструменты заменены: query-data-source, update-a-data-source и create-a-data-source. Обновите подсказки и сохранённые промпты под новые имена.

Частые вопросы

Чем этот сервер отличается от Remote Notion MCP?
Remote Notion MCP работает на серверах Notion, входит через OAuth, учитывает права каждого пользователя и ищет по смыслу. Локальный сервер требует токена интеграции и ручной выдачи доступа к страницам, а ищет только по ключевым словам.
Почему агент не видит мою страницу?
Страница не подключена к интеграции. Откройте вкладку Access в настройках интеграции или на самой странице выберите «⋯ → Connect to integration».
Куда делись инструменты для баз после обновления?
В версии 2.0.0 сервер перешёл на Notion API 2025-09-03: post-database-query, update-a-database и create-a-database заменены на query-data-source, update-a-data-source и create-a-data-source, а вместо database_id передаётся data_source_id.
Можно запустить сервер по HTTP?
Да: npx @notionhq/notion-mcp-server --transport http поднимает эндпоинт http://127.0.0.1:3000/mcp. Для продакшена задайте свой токен через --auth-token или AUTH_TOKEN и передавайте его в заголовке Authorization: Bearer.
Работает ли сервер из России?
Сервер запускается на вашем компьютере и работает с Notion API по токену интеграции; нужен аккаунт Notion.

Похожие серверы